π Quick Start
This guide will help you get started with the Wegent platform quickly.
π Prerequisitesβ
Before you begin, ensure your system has:
- Docker and Docker Compose
β‘ One-Click Startβ
curl -fsSL https://raw.githubusercontent.com/wecode-ai/Wegent/main/install.sh | bash
Then open http://localhost:3000 in your browser.
Optional: Enable RAG features with
docker compose --profile rag up -d
π¦ Built-in Agentsβ
| Team | Purpose |
|---|---|
| chat-team | General AI assistant + Mermaid diagrams |
| translator | Multi-language translation |
| dev-team | Git workflow: branch β code β commit β PR |
| wiki-team | Codebase Wiki documentation generation |
ποΈ Architectureβ
Frontend (Next.js) β Backend (FastAPI) β Executor Manager β Executors (ClaudeCode/Agno/Dify/Chat)
Core Concepts:
- Ghost (prompt) + Shell (environment) + Model = Bot
- Multiple Bots + Collaboration Mode = Team
π Next Stepsβ
Congratulations on starting Wegent! Here's what to explore next:
π Learn Moreβ
- Detailed Installation Guide - Learn about production deployment
- Core Concepts - Understand Ghost, Bot, Team, and more
- Architecture Overview - Learn about Wegent's architecture
π¨ Create Custom Agentsβ
- Agent Settings - Configure agents, bots, prompts, and collaboration modes
- Collaboration Models - Learn about multi-bot collaboration
π» Development & Extensionβ
- Development Setup - Set up local development environment
π§ Troubleshootingβ
Service Failed to Start?β
# View service logs
docker compose logs -f
# Restart services
docker compose restart
Cannot Access Web Interface?β
- Ensure port 3000 is not occupied
- Check if Docker containers are running:
docker compose ps
API Connection Failed?β
- Ensure backend service is running
- Visit
http://localhost:8000/api/docsto check API status
π Get Helpβ
- π Full Documentation
- π GitHub Issues
- π¬ Discord Community
Happy coding! π