# Wegent > 🚀 An open-source AI-native operating system to define, organize, and run intelligent agent teams English | [简体中文](README_zh.md) [![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://python.org) [![FastAPI](https://img.shields.io/badge/FastAPI-0.68+-green.svg)](https://fastapi.tiangolo.com) [![Next.js](https://img.shields.io/badge/Next.js-15+-black.svg)](https://nextjs.org) [![Docker](https://img.shields.io/badge/docker-ready-blue.svg)](https://docker.com) [![Claude](https://img.shields.io/badge/Claude-Code-orange.svg)](https://claude.ai) [![Gemini](https://img.shields.io/badge/Gemini-supported-4285F4.svg)](https://ai.google.dev) [![Version](https://img.shields.io/badge/version-1.0.20-brightgreen.svg)](https://github.com/wecode-ai/wegent/releases)

[Quick Start](#-quick-start) · [Documentation](https://wecode-ai.github.io/wegent-docs/) · [Development Guide](https://wecode-ai.github.io/wegent-docs/docs/category/developer-guide)

--- ## 🏗️ Architecture Overview ```mermaid graph TB subgraph Access["Entry Layer"] direction TB Web["🌐 Web"] IM["💬 IM Tools"] API["🔌 API"] end subgraph Features["Feature Layer"] direction TB Chat["💬 Chat"] Code["💻 Coding"] Feed["📡 Feed"] Knowledge["📚 Knowledge"] end subgraph Agents["Agent Layer"] direction TB ChatShell["🗣️ Wegent Chat"] ClaudeCode["🧠 Claude Code"] Agno["🤝 Agno"] Dify["✨ Dify"] end subgraph Execution["Execution Environment"] direction TB Docker["🐳 Agent Sandbox"] Cloud["☁️ Cloud Device"] Local["💻 Local Device"] end Access --> Features Features --> Agents Agents --> Execution ``` --- ## ✨ Core Features ### 💬 Chat Agent Chat Mode Demo

A fully open-source chat agent with powerful capabilities: - **Multi-Model Support**: Compatible with Claude, OpenAI, Gemini, DeepSeek, GLM and other mainstream models - **Conversation History**: Create new conversations, multi-turn dialogues, save and share chat history - **Group Chat**: AI group chat where AI responds based on conversation context with @mentions - **Attachment Parsing**: Send txt, pdf, ppt, doc, images and other file formats in single/group chats - **Follow-up Mode**: AI asks clarifying questions to help refine your requirements - **Error Correction Mode**: Multiple AI models automatically detect and correct response errors - **Long-term Memory**: Supports mem0 integration for conversation memory persistence - **Sandbox Execution**: Execute commands or modify files via sandbox, E2B protocol compatible - **Extensions**: Customize prompts, MCP tools and Skills (includes chart drawing skill) ### 💻 Code Agent Code Mode Demo

A cloud-based Claude Code execution engine: - **Multi-Model Configuration**: Configure various Claude-compatible models - **Concurrent Execution**: Run multiple coding tasks simultaneously in the cloud - **Requirement Clarification**: AI analyzes code and asks questions to generate specification documents - **Git Integration**: Integrate with GitHub/GitLab/Gitea/Gerrit to clone, modify and create PRs - **MCP/Skill Support**: Configure MCP tools and Skills for agents - **Multi-turn Conversations**: Continue conversations with follow-up questions ### 📡 AI Feed Feed Demo

A cloud-based AI task trigger system: - **Full Capability Access**: Tasks can use all Chat and Code mode capabilities - **Scheduled/Event Triggers**: Set up cron schedules or event-based AI task execution - **Information Feed**: Display AI-generated content as an information stream - **Event Filtering**: Filter conditions like "only notify me if it will rain tomorrow" ### 📚 AI Knowledge Knowledge Demo

A cloud-based AI document repository: - **Document Management**: Upload and manage txt/doc/ppt/xls and other document formats - **Web Import**: Import web pages and DingTalk multi-dimensional tables - **NotebookLM Mode**: Select documents directly in notebooks for Q&A - **Online Editing**: Edit text files directly in notebook mode - **Chat Integration**: Reference knowledge bases in single/group chats for AI responses ### 🖥️ AI Device AI Device Demo

Run AI tasks on your local machine with full control: - **Local Executor**: Install and run the Wegent executor on your own device - **Multi-Device Management**: Register and manage multiple local devices - **Default Device**: Set a preferred device for quick task execution - **Secure Connection**: Connect to Wegent backend via authenticated WebSocket ### 💬 IM Integration Integrate AI agents into your favorite IM tools: - **DingTalk Bot**: Deploy agents as DingTalk bots for team collaboration - **Telegram Bot**: Connect agents to Telegram for personal or group chats ### 🔧 Customization All features above are fully customizable: - **Custom Agents**: Create custom agents in the web UI, configure prompts, MCP, Skills and multi-agent collaboration - **Agent Creation Wizard**: 4-step creation: Describe requirements → AI asks questions → Real-time fine-tuning → One-click create - **Organization Management**: Create and join groups, share agents, models, Skills within groups --- ## 🔧 Extensibility - **Agent Creation Wizard**: 4-step creation: Describe requirements → AI asks questions → Real-time fine-tuning → One-click create - **Collaboration Modes**: 4 out-of-the-box multi-Agent collaboration modes (Sequential/Parallel/Router/Loop) - **Skill Support**: Dynamically load skill packages to improve Token efficiency - **MCP Tools**: Model Context Protocol for calling external tools and services - **Execution Engines**: ClaudeCode / Agno sandboxed isolation, Dify API proxy, Chat direct mode - **YAML Config**: Kubernetes-style CRD for defining Ghost / Bot / Team / Skill - **API**: OpenAI-compatible interface for easy integration with other systems --- ## 🚀 Quick Start **One command to start:** ```bash curl -fsSL https://raw.githubusercontent.com/wecode-ai/Wegent/main/install.sh | bash ``` Then open http://localhost:3000 in your browser. ### Other Deployment Options | Mode | Description | |------|-------------| | **Standalone** (default) | Single container, SQLite, recommended for most users | | **Standard** | Multi-container, MySQL, for production | | **Development** | Hot reload, for developers | ```bash # Standard mode (multi-container with MySQL) curl -fsSL https://raw.githubusercontent.com/wecode-ai/Wegent/main/install.sh | bash -s -- --standard # Development mode (from source, with hot reload) git clone https://github.com/wecode-ai/Wegent.git && cd Wegent && ./start.sh ```

🔧 Common Commands

```bash # Standalone mode (single container) docker logs -f wegent-standalone # View logs docker stop wegent-standalone # Stop docker start wegent-standalone # Start docker restart wegent-standalone # Restart # Standard mode (multi-container) docker compose logs -f # View logs docker compose down # Stop docker compose up -d # Start # Development mode ./start.sh --status # Check status ./start.sh --stop # Stop ./start.sh --restart # Restart ```

> 📖 See [Standalone Mode Documentation](docs/en/deployment/standalone-mode.md) for details. --- ## 📦 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 | --- ## 🤝 Contributing We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details. ## 📞 Support - 🐛 Issues: [GitHub Issues](https://github.com/wecode-ai/wegent/issues) - 💬 Discord: [Join our community](https://discord.gg/MVzJzyqEUp) ## 👥 Contributors Thanks to the following developers for their contributions and efforts to make this project better. 💪

_Axb	_MicroLee	_Feifei	_FicoHu	_{YaFei Liu}	_Yanhe	_Johnny0120	_Parabala
_Icycrystal4	_{Yi Xiang}	_Joyway78	_Moqimoqidea	_Xuemin	_{Jake Zhang}	_Fengkuizhi	_{Kerwin Bryant}
_Birch	_RockysGit	_{Just Quan}	_Junbaor	_Fingki	_李枨煊	_Jolestar	_Code-wangdi
_{Sense_wang}	_{Li Daiyan}	_Erdawang	_{Jasper Zhong}	_Ray	_RichardoMu	_{_}	_Andrewzq777
_Ch15084	_gdouyang	_Graindt	_Qingcheng	_Salt-hai	_Wxcfox

---

Made with ❤️ by WeCode-AI Team

himalaya-mail

Installation

SKILL.md