Local-first intelligent office automation — conversational AI, visual workflows, and 100+ tools in one deployable stack.
LeAgent is a self-hostable platform for building LLM-powered automation: chat assistants, drag-and-drop workflows, declarative rules, skills, and integrations — without stitching together separate products.
- Agent runtime — multi-turn sessions with streaming, tool execution, tiered model routing, layered prompts, and episodic / semantic / procedural cognitive memory
- Skills — Agent Skills v1.0
SKILL.mdbundles with progressive disclosure and on-demand loading; built-in skills, install from links/archives, and a pluggable HTTP skill registry - 100+ offline tools — documents, web, data, code execution, databases, generative UI, coding projects, and more
- Sidebar desk pet — customizable avatar and background, walk/jump animations, and personality bubbles; upload PNG / SVG / GIF or sprite sheets, synced with chat streaming and session state
- Visual workflows — ReactFlow editor with YAML export, templates, and every tool as a typed node
- Multi-provider LLM — DeepSeek, DashScope (Qwen), OpenAI, Ollama, vLLM, and more (DeepSeek is currently the most thoroughly validated; recommended for first use)
- Zero-config default — SQLite out of the box, single Docker container, optional PostgreSQL / Milvus
Prerequisites: git, uv, Node.js 20+ or 22+
git clone https://github.com/vixues/LeAgent.git
cd LeAgent
./start.sh # backend :7860 + frontend :5173cd LeAgent/deploy
cp .env.example .env # set LEAGENT_SECRET_KEY + provider keys
docker compose up -d --buildAPI at http://localhost:8000/docs.
# Backend
cd backend
uv sync --extra dev
uv run leagent init
uv run leagent app
# Frontend (separate terminal)
cd frontend
npm install && npm run devcurl -fsSL https://vixues.com.cn/install.sh | bashInstallers for each platform ship with every GitHub release — download and run. No separate Python, Node, or Docker install required.
| Platform | Download | Notes |
|---|---|---|
| Windows 10/11 (x64) | LeAgent-Setup-*.exe |
NSIS installer; desktop + start-menu shortcut |
| macOS (Apple Silicon) | LeAgent-*-arm64.dmg |
Unsigned — xattr -dr com.apple.quarantine /Applications/LeAgent.app after install |
| macOS (Intel) | LeAgent-*.dmg |
Same Gatekeeper note as above |
| Linux (x64) | LeAgent-*.AppImage / LeAgent-*.deb |
AppImage: chmod +x then run. .deb: sudo dpkg -i |
The desktop build bundles its own Python runtime and backend — ready to run after install.
See all releases: https://github.com/vixues/LeAgent/releases
Issues and pull requests are welcome. Please:
- Open an issue for larger changes or ambiguous scope.
- Run tests (
cd backend && uv run pytest tests/ -v/cd frontend && npm run test) for touched areas. - Follow
AGENTS.mdfor coding conventions and i18n rules.
See CONTRIBUTING.md for full guidelines.
Apache License 2.0 — see LICENSE.