https://github.com/Haohao-end/openagent
AI Agent Development Platform - Supports multiple models (OpenAI/DeepSeek/Wenxin/Tongyi), knowledge base management, workflow automation, and enterprise-grade security. Built with Flask + Vue3 + LangChain, featuring one-click Docker deployment.
https://github.com/Haohao-end/openagent
agent ai celery deepagents deepresearch deepseek docker faiss-vector-database flask harness-engineering langchain langgraph llmops mcp nginx postgresql skills tailwindcss vue weaviate
Last synced: about 7 hours ago
JSON representation
AI Agent Development Platform - Supports multiple models (OpenAI/DeepSeek/Wenxin/Tongyi), knowledge base management, workflow automation, and enterprise-grade security. Built with Flask + Vue3 + LangChain, featuring one-click Docker deployment.
- Host: GitHub
- URL: https://github.com/Haohao-end/openagent
- Owner: Haohao-end
- License: mit
- Created: 2025-06-20T02:04:17.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-06-22T09:17:12.000Z (5 days ago)
- Last Synced: 2026-06-22T11:12:04.686Z (5 days ago)
- Topics: agent, ai, celery, deepagents, deepresearch, deepseek, docker, faiss-vector-database, flask, harness-engineering, langchain, langgraph, llmops, mcp, nginx, postgresql, skills, tailwindcss, vue, weaviate
- Language: Python
- Homepage: https://openllm.cloud
- Size: 39.4 MB
- Stars: 815
- Watchers: 31
- Forks: 81
- Open Issues: 44
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
An end-to-end AI agent platform for building, orchestrating, publishing, and operating AI applications.
Flask + LangChain/LangGraph backend, Vue 3 workspace, visual workflows, datasets, tools, and OpenAPI delivery.
Sponsored by Atlas Cloud and Bloome
Visit Website
·
API Docs
·
中文文档
·
GitHub
## Table of Contents
- [About The Project](#about-the-project)
- [Architecture](#architecture)
- [Built With](#built-with)
- [Getting Started](#getting-started)
- [Usage](#usage)
- [Testing](#testing)
- [Contact](#contact)
- [Acknowledgments](#acknowledgments)
## About The Project
OpenAgent is a full-stack platform for teams building AI applications rather than a single chat demo. The repository combines a Flask backend, Celery workers, a Vue 3 frontend, visual workflow authoring, dataset and document management, public app and workflow publishing, and OpenAPI-based delivery.
What the current codebase already supports:
- Use the home assistant to route user requests to published public agents through A2A, or turn natural-language requirements into new AI app creation flows.
- Build and manage AI apps from a dedicated workspace with draft, publish, analysis, version comparison, and prompt comparison flows.
- Enable Deep Research to let the app decompose complex tasks and coordinate bound capabilities across multi-step execution, suitable for scenarios requiring deep reasoning and concrete outputs.
- Design workflows visually with nodes for LLMs, tool calls, dataset retrieval, code execution, HTTP requests, branching, text processing, template transforms, and structured parameter extraction.
- Manage datasets, upload documents, inspect segments, and connect retrieval to agents and workflows.
- Browse public apps, tools, and workflows through store-style views.
- Expose published apps over REST and SSE through `POST /api/openapi/chat`.
## Architecture
Click the diagram to view the full-resolution architecture image.
### Built With
- AI framework and orchestration: LangChain, LangGraph, workflow orchestration, tool calling, A2A delegation, skills, memory
- Knowledge and retrieval: RAG, semantic retrieval, full-text retrieval, hybrid retrieval, Weaviate, FAISS
- Backend: Python, Flask, SQLAlchemy, Celery, Flask-SocketIO, Redis, PostgreSQL
- Frontend: Vue 3, JavaScript / TypeScript, Vite, TailwindCSS, Pinia, Vue Flow, Arco Design
- Infrastructure and delivery: Docker Compose, Nginx, OpenAPI, SSE
- Model integrations: OpenAI, Atlas Cloud, DeepSeek, Grok, Google, Moonshot, Tongyi, Wenxin, Ollama, Zhipu
### Sponsored By
#### Atlas Cloud
- Atlas Cloud is a model provider on OpenRouter. Integrate it in this project via `ATLASCLOUD_API_KEY` and `ATLASCLOUD_API_BASE`.
- Official website: [Atlas Cloud](https://www.atlascloud.ai/?utm_source=github&utm_medium=link&utm_campaign=openagent)
- Integration docs: [https://www.atlascloud.ai/docs](https://www.atlascloud.ai/docs)
#### Bloome
- Bloome is an AI-agent IM platform where you can interact with AI agents and build collaborative communities. Official website: [Bloome](https://bloome.im/agent/join/j5CfmWJj?ref=uqIIEORd)
## Getting Started
### Prerequisites
- Docker 20.10+
- Docker Compose 2.x
- 8 GB+ RAM recommended for the full stack
- Access to at least one supported model provider API key
### Installation
1. Clone the repository.
```bash
git clone https://github.com/Haohao-end/openagent.git
cd openagent
```
2. Create the runtime environment file.
```bash
cp api/.env.example api/.env
```
3. Review the minimum required settings in `api/.env`.
- `JWT_SECRET_KEY`
- `POSTGRES_PASSWORD`
- `REDIS_PASSWORD`
- `WEAVIATE_API_KEY`
- `VITE_API_PREFIX`
- At least one provider key such as `OPENAI_API_KEY`, `ATLASCLOUD_API_KEY`, `DEEPSEEK_API_KEY`, or `DASHSCOPE_API_KEY`
4. Start the Docker stack.
```bash
cd docker
docker compose up -d --build
```
5. Open the local services.
| Service | URL | Notes |
| --- | --- | --- |
| Frontend | http://localhost:3000 | Vue 3 web UI |
| API | http://localhost:5001 | Flask REST API |
| Nginx | http://localhost | Reverse proxy |
### Local Development
Backend:
```bash
cd api
pip install -r requirements.txt
flask run --port 5001
```
Frontend:
```bash
cd ui
npm install
npm run serve
```
Vite serves the frontend on port `5173` by default. The frontend configuration resolves the API base from `VITE_API_PREFIX`, and local development commonly proxies `/api` to the Flask backend.
Useful commands:
```bash
cd api
pytest
```
```bash
cd ui
npm run type-check
npm run lint
npm run build
npm run test:unit -- --run
```
## Usage
### 1. Home Assistant Experience
Use the home page as the default assistant entry point to route user questions to the most relevant published public agents through A2A, or describe a new idea in natural language and trigger AI app creation. The same surface also supports multi-turn chat, suggested prompts, image upload, and audio input.
### 2. App Workspace and Deep Research
The app workspace is the main work area for an AI app, not a standalone settings page. The left side handles model, prompt, and capability bindings. The right side is used for live debugging, execution traces, and result checks. In the current codebase, the README term `Deep Research` maps to the deep thinking mode behind `enable_deep_thinking`.
Key capabilities:
- Configuration and version management: manage model changes, prompt logic, drafts, publishing, version comparison, prompt comparison, and app duplication in one place.
- Capability integration: bind plugins, MCP, Skills, child Agent apps, workflows, and datasets through a single workspace.
- Complex task execution: with `Deep Research` enabled, the app can break work into steps and coordinate bound capabilities across a longer execution chain.
- Sandbox and artifact output: support script execution, code handling, file generation, and attachment export for tasks that need concrete outputs.
- Debugging and result verification: use the right-side panel to run real conversations and inspect deep execution timelines, task state, produced artifacts, and final results.
### 3. Visual Workflow Editor
Author workflows with nodes such as LLM, tool, dataset retrieval, code, HTTP request, template transform, text processor, variable assigner, parameter extractor, if/else, start, and end.
### 4. Dataset and Retrieval
Create datasets, upload documents, inspect segments, and wire retrieval nodes into workflows or AI apps for knowledge-enabled behavior.
### 5. OpenAPI Delivery
Publish an app and call it over `POST /api/openapi/chat` with standard or streaming responses, including support for multi-turn conversation identifiers.
## Testing
The repository already includes automated backend and frontend tests.
- Backend: `cd api && pytest`
- Frontend unit tests: `cd ui && npm run test:unit -- --run`
- Frontend type check: `cd ui && npm run type-check`
- Frontend build validation: `cd ui && npm run build`
## Contact
- Project Link: https://github.com/Haohao-end/openagent
- Website: https://openllm.cloud
- API Docs: https://s.apifox.cn/c76bd530-fd50-429c-94cc-f0e41c2675d1/api-305434417
- DeepWiki: https://deepwiki.com/Haohao-end/openagent
## Acknowledgments
- Thanks to Atlas Cloud and Bloome for supporting OpenAgent.
- Special thanks to Rui Yang and Haoyu Wang (Johns Hopkins University) for responsibly reporting a Host Header poisoning issue in the built-in tool icon URL construction and helping improve the security of this project.
- Special thanks to Ryan B for responsibly reporting an SSRF vulnerability in the custom API-tool server URL and helping improve the project's outbound request security.