An open-source, self-hostable platform for building and running AI agent teams.
English | 简体中文
Wegent helps teams create and share AI agents that perform real work across chat, coding, knowledge, and automation. Manage team capabilities on the web, and use Wework when agents need to work directly with local projects and development environments.
| Scenario | What Wegent provides |
|---|---|
| Team AI assistants | A private chat entry point with shared models, knowledge, skills, group collaboration, and file handling |
| AI coding | Change code, run tests, commit updates, and open pull requests in isolated or local environments |
| Knowledge assistants | Parse and index documents, webpages, and enterprise data for grounded answers |
| Continuous automation | Track information, analyze webpages, filter notifications, and publish feeds from schedules and events |
| Local and private-network execution | Work with local code, CLIs, browsers, dedicated development environments, and intranet resources |
| Existing system integration | Bring agents into applications and team tools through APIs, MCP, and IM bots |
| Use Wegent Web | Use Wework |
|---|---|
| Create and share agents, models, knowledge bases, and automation | Open local projects and let AI use files, terminals, CLIs, and development environments |
| Manage users, permissions, and execution devices | Use local Codex, local models, and the local executor |
| Serve teams through the browser, APIs, and IM | Focus on daily AI coding and local workflows |
Wework can connect to a team deployment of Wegent to use shared models, cloud devices, and remote tasks while working locally.
Deploy Wegent · Download Wework
| Capability | Benefit |
|---|---|
| Reuse capabilities | Combine models, knowledge, tools, and skills into agents that work across many tasks |
| Let bots collaborate | Organize bots to divide research, analysis, coding, and review work |
| Run tasks in the right place | Choose cloud, containers, local devices, or private environments based on where code and data live |
| Reach teams from every entry point | Use the same agent capabilities from the web, Wework, APIs, and IM |
Prerequisite: Docker. Run Wegent in a single container with SQLite:
curl -fsSL https://raw.githubusercontent.com/wecode-ai/Wegent/main/install.sh | bash -s -- --standaloneAfter it starts:
- Open http://localhost:3000.
- Follow the setup flow to create the administrator password.
- Configure a model and API key in Settings.
- Choose a built-in agent and send your first message.
Common management commands:
wegent-standalone status
wegent-standalone logs
wegent-standalone restart
wegent-standalone stopIf the command is not in your current PATH, use ~/.local/bin/wegent-standalone.
Download Wework and open a local project to start AI coding. Wework includes local execution and can also connect to a team deployment of Wegent from Settings.
| Option | Best for | Start here |
|---|---|---|
| Standalone | Personal trials and lightweight self-hosting | Use the install command above |
| Standard | Team deployments with MySQL, Redis, and dedicated services | Installation Guide |
| Development | Contributing and extending Wegent | Development Setup |
Standalone can also use host, container, or hybrid executor modes. See Standalone Mode for details.
See how Wegent organizes agents and tasks
Wegent manages capabilities, collaboration, and runtime context separately so they can be reused across tasks and environments.
Ghost (prompt + MCP + skills)
+ Shell (Chat / ClaudeCode / Agno / Dify)
+ Model
= Bot
Multiple Bots + collaboration mode = Team (the user-facing Agent)
Team + Workspace = Task (a traceable execution)
Manage these resources through the UI, YAML, or APIs. See Core Concepts and the YAML Specification for details.
View Wegent's technical components
graph TB
User["User / API / IM"] --> Frontend["Wegent Web<br/>Next.js"]
User --> Wework["Wework Desktop<br/>Tauri + React"]
Frontend --> Backend["Backend<br/>FastAPI"]
Wework -. "Optional cloud connection" .-> Backend
Wework --> LocalWork["Local Codex / Files / Terminal"]
Backend --> Database[("MySQL / SQLite")]
Backend --> Redis[("Redis")]
Backend --> ChatShell["Chat Shell"]
Backend --> ExecutorManager["Executor Manager"]
Backend --> KnowledgeRuntime["Knowledge Runtime"]
ExecutorManager --> CloudExecutor["Cloud / Container Executor"]
Backend <--> LocalExecutor["Local Executor"]
KnowledgeRuntime --> VectorStore["Elasticsearch / Qdrant / Milvus"]
KnowledgeRuntime --> DocConverter["Document Converter"]
| Directory | Responsibility |
|---|---|
frontend/ |
Wegent Web product |
backend/ |
REST API and core business logic |
wework/ |
Tauri desktop workbench |
executor/ |
Agent task execution environments |
executor_manager/ |
Executor scheduling and orchestration |
chat_shell/ |
Chat runtime |
knowledge_runtime/ |
Knowledge retrieval services |
knowledge_doc_converter/ |
Document parsing and conversion |
shared/ |
Modules shared across services |
- Quick Start
- Installation and Deployment
- Core Concepts
- User Guide
- OpenAPI Responses API
- Developer Guide
- Troubleshooting
Bug reports, documentation improvements, code contributions, and new ways of using Wegent are all welcome.
Thanks to everyone who helps Wegent grow.
Made with ❤️ by WeCode-AI Team