🌌 AgentSpace

The Space for Every AI Agent

Discover, build, deploy, and battle custom AI agents in the world's largest marketplace and repository system for intelligent automation.

---

🚀 Overview

AgentSpace is a modern, scalable, and modular AI agent marketplace and execution platform. Designed with a GitHub-like experience, it empowers developers and users to explore, create, and interact with autonomous AI agents. Whether you need a code debugger, a legal summarizer, or a creative writing assistant, AgentSpace provides the infrastructure to run, fork, and evaluate agents securely.

✨ Key Features

• 🛒 Agent Marketplace: Explore a rich directory of high-quality AI agents organized by categories (Coding, Business, Career, Legal, etc.). Filter by Top Rated or Most Stars.
• 🛠️ Auto Repo Builder: Don't want to write code? Generate comprehensive agent configurations, prompt templates, and README files entirely from natural language descriptions using Gemini AI.
• ⚔️ Battle Mode: Compare two agents side-by-side. Provide a single prompt and watch how different agents handle the specific task, evaluating their performance, speed, and accuracy in real-time.
• 🏃 Secure Execution: Run interactive, chat, and input-output agents directly from their repository pages with real inputs and structured outputs.
• 🐙 GitHub-style Ecosystem: Every agent has its own repository featuring Live Demos, READMEs, Issues, Pull Requests, agent.yaml Configs, and SDK usage examples.
• 👤 Developer Profiles: Showcase your created agents, track your contributions, and build a following in the AgentSpace ecosystem.

💻 Tech Stack

• Framework: Next.js 15 (App Router)
• UI Library: React 19, shadcn/ui, Tailwind CSS, Radix UI
• AI Engine: Google Genkit powered by Google Gemini Models (@genkit-ai/google-genai)
• Backend & Auth: Firebase v11 (Firestore & Authentication)
• Icons & Styling: Lucide React, CSS Modules

⚙️ Getting Started

Follow these steps to set up AgentSpace locally on your machine.

Prerequisites

• Node.js (v20 or higher)
• npm or yarn or pnpm
• A Google Gemini API Key

Installation

1. Clone the repository:

   git clone https://github.com/goblinasaddy/AgentSpace.git
   cd AgentSpace

2. Install dependencies:

   npm install

3. Set up environment variables: Create a .env.local or .env file in the root directory and add your Gemini API key:

   GEMINI_API_KEY=your_gemini_api_key_here

4. Run the development server:

   npm run dev

5. Open your browser: Navigate to http://localhost:9002 (Port 9002 is configured via package.json turbopack) to see the application running.

📂 Project Structure

AgentSpace/
├── src/
│   ├── ai/            # Genkit flows and AI logic (Auto Repo Builder)
│   ├── app/           # Next.js App Router pages (/, /explore, /agent, /profile, /battle, /create)
│   ├── components/    # Reusable React components & shadcn/ui elements
│   ├── context/       # React Context providers (AgentsState)
│   ├── hooks/         # Custom React hooks (useToast)
│   └── lib/           # Utility functions, mocked data, types
├── docs/              # Project blueprints and documentation
├── public/            # Static assets
└── package.json       # Project dependencies and scripts

🤝 Contributing

Contributions are completely welcome! Please feel free to submit a Pull Request.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Built with ❤️ for the future of Autonomous Agents.