Self-hosted intelligent agent publishing platform. Create, configure, and publish AI agents with multi-provider support, MCP tools, custom skills, workspace IDE, and an OpenAI-compatible API.

• Multi-Provider Support - Connect OpenAI, Anthropic, Gemini, DeepSeek, Qwen, Zhipu, Moonshot with unified management
• Agent Lifecycle - Create, configure, version, and archive agents with share token support
• MCP Integration - Browse marketplace and add custom MCP servers (STDIO/SSE/Streamable HTTP)
• Skills Marketplace - Admin-curated system skills + user custom skills for agents
• Streaming Chat UI - Real-time conversation interface with multi-part message rendering
• Workspace IDE - In-browser file editor with Monaco, file tree, and AI-driven file operations (create, read, update, delete, search, patch)
• OpenAI-Compatible API - Expose agents via /v1/chat/completions endpoint with API key auth
• User Preferences - Theme and language preferences persisted in database, synced across devices on login
• User Management - Admin panel for user CRUD, role/status management, and password reset
• Secure by Default - JWT auth, AES-256-GCM encrypted provider keys, API key management

git clone <your-repo-url>
cd agent-x
cp .env.example .env
# Edit .env — set DB_PASSWORD, JWT_SECRET, ENCRYPTION_SECRET
docker compose up -d

Open http://localhost to access the web UI.

• Node.js 22
• pnpm 9.15.0
• PostgreSQL 16

# Install dependencies
pnpm install

# Configure environment
cp packages/server/.env.example packages/server/.env
# Edit packages/server/.env with your database credentials

# Run database migrations
cd packages/server && npx prisma migrate dev && cd ../..

# Start dev servers (frontend :5173 + backend :3000)
pnpm dev

pnpm dev            # Start all dev servers
pnpm build          # Build all packages
pnpm test           # Run all tests
pnpm typecheck      # Type check all packages
pnpm lint           # Lint all packages
pnpm format         # Format code with Prettier

# Database
pnpm db:migrate     # Run migrations
pnpm db:generate    # Regenerate Prisma client
pnpm db:studio      # Open Prisma Studio

agent-x/
├── packages/
│   ├── server/          # NestJS backend
│   │   ├── prisma/      # Database schema & migrations
│   │   └── src/modules/ # auth, provider, agent, skill, mcp, chat, workspace, public-chat, preferences, api-key, openai-compat, user, system-config
│   ├── web/             # React frontend
│   │   └── src/
│   │       ├── pages/       # login, register, dashboard/*, chat, shared
│   │       ├── components/  # chat, workspace, agents, shared, auth, ui (shadcn)
│   │       ├── contexts/    # React contexts (workspace API switching)
│   │       ├── hooks/       # React Query hooks
│   │       ├── lib/         # Utilities, transports, schemas
│   │       └── stores/      # Zustand stores
│   └── shared/          # Shared TypeScript types & DTOs
├── docker/              # Dockerfiles & nginx config
├── docker-compose.yml   # Production deployment
└── turbo.json           # Turborepo pipeline

All backend routes are prefixed with /api except the OpenAI-compatible endpoint.

Expose any published agent as an OpenAI-compatible endpoint:

curl http://localhost:3000/v1/chat/completions \
  -H "Authorization: Bearer sk-agx-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-agent-id",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'

MIT