Skip to content

Repository files navigation

GenAgentX Logo

GenAgentX

Build Intelligent AI Agents — No Code Required

License: MIT Made with React Powered by Gemini

A visual interface for creating, customizing, and deploying AI agents powered by Google Gemini. Design AI tools, assistants, and workflows — all within your browser.

Start Building Now →


Features

  • 🎯 Define Clear Roles – Assign specific roles, goals, and tasks to your AI agents for focused results
  • Lightning Fast Creation – Build and deploy agents in minutes with Google Gemini’s Flash models
  • 🔧 Custom Parameters – Adjust tone, style, temperature, and creativity with intuitive controls
  • 💬 AI Assistant Helper – A built-in guide that suggests goals, parameters, and configurations
  • 🧠 Multiple Models – Choose between Gemini Flash, Pro, or Lite for different workloads
  • 💾 Offline Local Storage – Your agents are stored privately in the browser using IndexedDB
  • 🎨 Beautiful Interface – Minimal, modern UI with Markdown previews and syntax highlighting
  • 🔐 Secure by Design – Your API key is stored locally and never transmitted to any external server

🧩 Use Cases

  • 📝 Content Creation Agents – Generate blogs, social posts, ad copy, or newsletters
  • 💼 Data & Code Assistants – Build prompt-driven coding or analysis helpers
  • 🎨 Creative AI Tools – Design story writers, script generators, or idea brainstormers
  • 💬 Conversational Bots – Create chat-based agents with unique tones and personalities
  • 🧪 Automation Workflows – Prototype no-code automation pipelines with Gemini APIs

🛠️ Tech Stack

⚙️ Frontend

  • React 18 – Modern reactive UI framework
  • Vite – Lightning-fast development build tool
  • CSS3 – Custom gradients, transitions, and animations

🧠 AI & Backend

  • Google Gemini AI – Large language models for reasoning and creativity
  • IndexedDB – Client-side database for storing agents and configurations

📚 Libraries

  • react-markdown – Render markdown content beautifully
  • remark-gfm – GitHub Flavored Markdown support
  • react-syntax-highlighter – Code syntax highlighting

💻 Installation & Setup

✅ Prerequisites

  • Node.js (v18 or higher)
  • npm or yarn
  • A Google Gemini API KeyGet one here

⚡ Installation Steps

# Clone the repository
git clone https://github.com/suhas991/GenAgentX.git

# Navigate to the project directory
cd GenAgentX

# Install dependencies
npm install

# Start the development server
npm run dev

Then open http://localhost:5173/ in your browser to access GenAgentX.


🧠 Creating an Agent

  1. Click "Create New Agent"
  2. Fill in:
    • Agent Name: e.g., Article Writer Pro
    • Role: Senior Content Strategist
    • Goal: Generate SEO-optimized blog articles
  3. Choose a Gemini Model (Flash, Pro, Lite)
  4. Define Custom Parameters like tone, temperature, word limit, etc.
  5. Hit Create Agent → Your AI is ready to execute tasks instantly!

🧑‍💻 Contributing

Contributions are always welcome! ❤️
Here’s how you can help:

  1. Fork the repo
  2. Create a new branch
    git checkout -b feature/AmazingFeature
  3. Commit your changes
    git commit -m "Add some AmazingFeature"
  4. Push to your branch
    git push origin feature/AmazingFeature
  5. Open a Pull Request on GitHub

🧭 Development Guidelines

  • Follow React best practices (functional components + hooks)
  • Maintain consistent code style and structure
  • Comment complex logic clearly
  • Test thoroughly before submitting

🐞 Known Issues

  • 📱 Mobile Devices: Not yet optimized (desktop-only for now)
  • 🔐 API Key Validation: Occurs only on the first execution
  • 💾 Storage Limit: IndexedDB limited to ~50MB depending on browser

📜 License

This project is licensed under the MIT License.

MIT License  
Copyright (c) 2025 Suhas N H  

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software.

🌟 Show Your Support

If you find GenAgentX helpful:

  • ⭐ Star the repo
  • 🐦 Share it on Twitter / LinkedIn
  • 🧠 Build and showcase your own agents!

"GenAgentX empowers creators and developers to turn AI ideas into reality — visually, instantly, and securely."

About

Turn prompts into reusable, goal-oriented AI agents in seconds.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages