Skip to content
View openakita's full-sized avatar

Block or report openakita

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don't include any personal information such as legal names or email addresses. Markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
openakita/README.md

OpenAkita Logo

OpenAkita

Open-Source Multi-Agent AI Assistant β€” Not Just Chat, an AI Team That Gets Things Done

License Python Version Version PyPI Build Status

Multi-Agent Collaboration Β· 30+ LLMs Β· 6 IM Platforms Β· 89+ Tools Β· Desktop / Web / Mobile

Capabilities β€’ 5-Min Setup β€’ Multi-Platform β€’ Multi-Agent β€’ Docs

English | δΈ­ζ–‡


What is OpenAkita?

Other AIs just chat. OpenAkita gets things done.

OpenAkita is an open-source, all-in-one AI assistant β€” multiple AI Agents work together, search the web, operate your computer, manage files, run scheduled tasks, and respond instantly across Telegram / Slack / DingTalk / Feishu / QQ. It remembers your preferences, teaches itself new skills, and never gives up on a task.

Fully GUI-based setup. Ready in 5 minutes. Zero command line required.

Download: GitHub Releases β€” Windows / macOS / Linux


Core Capabilities

🀝 Multi-Agent Collaboration

Multiple AI agents with specialized skills work in parallel. Say one thing β€” a coding Agent writes code, a writing Agent drafts docs, a testing Agent verifies β€” all at the same time.

πŸ“‹ Plan Mode

Complex tasks auto-decomposed into step-by-step plans with real-time progress tracking and automatic rollback on failure.

🧠 ReAct Reasoning Engine

Think β†’ Act β†’ Observe. Explicit three-phase reasoning with checkpoint/rollback. Fails? Tries a different strategy.

πŸ”§ 89+ Tools β€” Actually Does Things

Web search Β· Desktop automation Β· File management Β· Browser automation Β· Scheduled tasks Β· MCP extensions …

πŸš€ 5-Min Setup β€” Zero Command Line

Download β†’ Install β†’ Follow the wizard β†’ Enter API Key β†’ Start chatting. Fully GUI-based, no terminal needed.

🌐 30+ LLM Providers

DeepSeek / Qwen / Kimi / Claude / GPT / Gemini … One goes down, the next picks up automatically.

πŸ’¬ 6 IM Platforms

Telegram / Feishu / WeCom / DingTalk / QQ / OneBot β€” use AI right inside your daily chat tools.

πŸ’Ύ Long-Term Memory

Three-layer memory system + AI extraction. Remembers your preferences, habits, and task history.


Full Feature List

Feature Description
🀝 Multi-Agent Specialized agents, parallel delegation, automatic handoff, failover, real-time visual dashboard
πŸ“‹ Plan Mode Auto task decomposition, per-step tracking, floating progress bar in UI
🧠 ReAct Reasoning Explicit 3-phase loop, checkpoint/rollback, loop detection, strategy switching
πŸš€ Zero-Barrier Setup Full GUI config, onboarding wizard, 5 minutes from install to chat, zero CLI
πŸ”§ 89+ Built-in Tools 16 categories: Shell / Files / Browser / Desktop / Search / Scheduler / MCP …
πŸ›’ Skill Marketplace Search & one-click install, GitHub direct install, AI-generated skills on the fly
🌐 30+ LLM Providers Anthropic / OpenAI / DeepSeek / Qwen / Kimi / MiniMax / Gemini … smart failover
πŸ’¬ 6 IM Platforms Telegram / Feishu / WeCom / DingTalk / QQ / OneBot, voice recognition, smart group chat
πŸ’Ύ 3-Layer Memory Working + Core + Dynamic retrieval, 7 memory types, AI-driven extraction & review
🎭 8 Personas Default / Tech Expert / Boyfriend / Girlfriend / Jarvis / Butler / Business / Family
πŸ€– Proactive Engine Greetings, task follow-ups, idle chat, goodnight β€” adapts frequency to your feedback
🧬 Self-Evolution Daily self-check & repair, failure root cause analysis, auto skill generation
πŸ” Deep Thinking Controllable thinking mode, real-time chain-of-thought display, IM streaming
πŸ›‘οΈ Runtime Supervision Tool thrashing detection, resource budgets, policy engine, deterministic validators
πŸ”’ Safety & Governance POLICIES.yaml, dangerous ops require confirmation, local data storage
πŸ–₯️ Multi-Platform Desktop (Win/Mac/Linux) Β· Web (PC & mobile browser) Β· Mobile App (Android/iOS), 11 panels, dark theme
πŸ“Š Observability 12 trace span types, full-chain token statistics panel
πŸ˜„ Stickers 5700+ stickers, mood-aware, persona-matched

5-Minute Setup

Option 1: Desktop App (Recommended)

Fully GUI-based, no command line β€” this is what sets OpenAkita apart from other open-source AI assistants:

OpenAkita Quick Setup

Step What You Do Time
1 Download installer, double-click to install 1 min
2 Follow the onboarding wizard, enter API Key 2 min
3 Start chatting Now
  • No Python installation, no git clone, no config file editing
  • Isolated runtime β€” won't mess with your existing system
  • Chinese users get automatic mirror switching
  • Models, IM channels, skills, schedules β€” all configured in the GUI

Download: GitHub Releases β€” Windows (.exe) / macOS (.dmg) / Linux (.deb)

Option 2: pip Install

pip install openakita[all]    # Install with all optional features
openakita init                # Run setup wizard
openakita                     # Launch interactive CLI

Option 3: Source Install

git clone https://github.com/openakita/openakita.git
cd openakita
python -m venv venv && source venv/bin/activate
pip install -e ".[all]"
openakita init

Commands

openakita                              # Interactive chat
openakita run "Build a calculator"     # Execute a single task
openakita serve                        # Service mode (IM channels)
openakita serve --dev                  # Dev mode with hot reload
openakita daemon start                 # Background daemon
openakita status                       # Check status

Multi-Platform Access

OpenAkita supports Desktop, Web, and Mobile β€” use it anywhere, on any device:

Platform Details
πŸ–₯️ Desktop App Windows / macOS / Linux β€” native app built with Tauri 2.x
🌐 Web Access PC & mobile browser β€” enable remote access, open in any browser
πŸ“± Mobile App Android (APK) / iOS (TestFlight) β€” native wrapper via Capacitor

Desktop App

OpenAkita Desktop App

Cross-platform desktop app built with Tauri 2.x + React + TypeScript:

Panel Function
Chat AI chat, streaming output, Thinking display, drag & drop upload, image lightbox
Agent Dashboard Neural network visualization, real-time multi-Agent status tracking
Agent Manager Create, manage, and configure multiple Agents
IM Channels One-stop setup for all 6 platforms
Skills Marketplace search, install, enable/disable
MCP MCP server management
Memory Memory management + LLM-powered review
Scheduler Scheduled task management
Token Stats Token usage statistics
Config LLM endpoints, system settings, advanced options
Feedback Bug reports + feature requests

Dark/light theme Β· Onboarding wizard Β· Auto-update Β· Bilingual (EN/CN) Β· Start on boot

Mobile App

β–Ά Watch Mobile App Demo
β–Ά Click to watch the Mobile App demo on Bilibili

  • Connect your phone to the desktop backend over local network
  • Full-featured: chat, multi-Agent collaboration, memory, skills, MCP β€” all on mobile
  • Supports real-time streaming and Thinking chain display
  • Preview mode available without connecting to a server

Multi-Agent Collaboration

β–Ά Watch Multi-Agent Collaboration Demo
β–Ά Click to watch the Multi-Agent collaboration demo on Bilibili

OpenAkita has a built-in multi-Agent orchestration system β€” not just one AI, but an AI team:

You: "Create a competitive analysis report"
    β”‚
    β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚      AgentOrchestrator (Director)     β”‚
β”‚   Decomposes task β†’ Assigns to Agents β”‚
β””β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”˜
    β–Ό            β–Ό              β–Ό
 Search Agent  Analysis Agent  Writing Agent
 (web research) (data crunching) (report drafting)
    β”‚            β”‚              β”‚
    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                 β–Ό
         Results merged, delivered to you
  • Specialization: Different Agents for different domains, auto-matched to tasks
  • Parallel Processing: Multiple Agents work simultaneously
  • Auto Handoff: If one Agent gets stuck, it hands off to a better-suited one
  • Failover: Agent failure triggers automatic switch to backup
  • Depth Control: Max 5 delegation levels to prevent runaway recursion
  • Visual Tracking: Agent Dashboard shows real-time status of every Agent

30+ LLM Providers

No vendor lock-in. Mix and match freely:

Category Providers
Local Ollama Β· LM Studio
International Anthropic Β· OpenAI Β· Google Gemini Β· xAI (Grok) Β· Mistral Β· OpenRouter Β· NVIDIA NIM Β· Groq Β· Together AI Β· Fireworks Β· Cohere
China Alibaba DashScope Β· Kimi (Moonshot) Β· MiniMax Β· DeepSeek Β· SiliconFlow Β· Volcengine Β· Zhipu AI Β· Baidu Qianfan Β· Tencent Hunyuan Β· Yunwu Β· Meituan LongCat Β· iFlow

7 capability dimensions: Text Β· Vision Β· Video Β· Tool use Β· Thinking Β· Audio Β· PDF

Smart failover: One model goes down, the next picks up seamlessly.

Recommended Models

Model Provider Notes
claude-sonnet-4-5-* Anthropic Default, balanced
claude-opus-4-5-* Anthropic Most capable
qwen3-max Alibaba Strong Chinese support
deepseek-v3 DeepSeek Cost-effective
kimi-k2.5 Moonshot Long-context
minimax-m2.1 MiniMax Great for dialogue

For complex reasoning, enable Thinking mode β€” add -thinking suffix to the model name.


6 IM Platforms

Talk to your AI right inside the chat tools you already use:

Platform Connection Highlights
Telegram Webhook / Long Polling Pairing verification, Markdown, proxy support
Feishu WebSocket / Webhook Card messages, event subscriptions
WeCom Smart Robot callback Streaming replies, proactive push
DingTalk Stream WebSocket No public IP needed
QQ Official WebSocket / Webhook Groups, DMs, channels
OneBot WebSocket Compatible with NapCat / Lagrange / go-cqhttp
  • πŸ“· Vision: Send screenshots/photos β€” AI understands them
  • 🎀 Voice: Send voice messages β€” auto-transcribed and processed
  • πŸ“Ž File Delivery: AI-generated files pushed directly to chat
  • πŸ‘₯ Group Chat: Replies when @mentioned, stays quiet otherwise
  • πŸ’­ Chain-of-Thought: Real-time reasoning process streamed to IM

Memory System

Not just a "context window" β€” true long-term memory:

  • Three layers: Working memory (current task) + Core memory (user profile) + Dynamic retrieval (past experience)
  • 7 memory types: Fact / Preference / Skill / Error / Rule / Persona trait / Experience
  • AI-driven extraction: Automatically distills valuable information after each conversation
  • Multi-path recall: Semantic + full-text + temporal + attachment search
  • Gets smarter over time: Preferences you mentioned two months ago? Still remembered.

Self-Evolution

OpenAkita keeps getting stronger:

Daily 04:00   β†’  Self-check: analyze error logs β†’ AI diagnosis β†’ auto-fix β†’ push report
After failure β†’  Root cause analysis (context loss / tool limitation / loop / budget) β†’ suggestions
Missing skill β†’  Auto-search GitHub for skills, or AI generates one on the spot
Missing dep   β†’  Auto pip install, auto mirror switching for China
Every chat    β†’  Extract preferences and experience β†’ long-term memory

Safety & Governance

  • Policy Engine: POLICIES.yaml for tool permissions, shell command blocklist, path restrictions
  • Confirmation: Dangerous operations (file deletion, system commands) require user approval
  • Resource Budgets: Token / cost / duration / iteration / tool call limits per task
  • Runtime Supervision: Auto-detection of tool thrashing, reasoning loops, token anomalies
  • Local Data: Memory, config, and chat history stored on your machine only
  • Open Source: Apache 2.0, fully transparent codebase

Architecture

Desktop App (Tauri + React)
    β”‚
Identity ─── SOUL.md Β· AGENT.md Β· POLICIES.yaml Β· 8 Persona Presets
    β”‚
Core     ─── ReasoningEngine(ReAct) Β· Brain(LLM) Β· ContextManager
    β”‚        PromptAssembler Β· RuntimeSupervisor Β· ResourceBudget
    β”‚
Agents   ─── AgentOrchestrator(Coordination) Β· AgentInstancePool(Pooling)
    β”‚        AgentFactory Β· FallbackResolver(Failover)
    β”‚
Memory   ─── UnifiedStore(SQLite+Vector) Β· RetrievalEngine(Multi-path)
    β”‚        MemoryExtractor Β· MemoryConsolidator
    β”‚
Tools    ─── Shell Β· File Β· Browser Β· Desktop Β· Web Β· MCP Β· Skills
    β”‚        Plan Β· Scheduler Β· Sticker Β· Persona Β· Agent Delegation
    β”‚
Evolution ── SelfCheck Β· FailureAnalyzer Β· SkillGenerator Β· Installer
    β”‚
Channels ─── CLI Β· Telegram Β· Feishu Β· WeCom Β· DingTalk Β· QQ Β· OneBot
    β”‚
Tracing  ─── AgentTracer(12 SpanTypes) Β· DecisionTrace Β· TokenStats

Documentation

Document Content
Configuration Guide Desktop Quick Setup & Full Setup walkthrough
⭐ LLM Provider Setup API Key registration + endpoint config + Failover
⭐ IM Channel Setup Telegram / Feishu / DingTalk / WeCom / QQ / OneBot tutorial
Quick Start Installation and basics
Architecture System design and components
Configuration All config options
Deployment Production deployment
MCP Integration Connecting external services
Skill System Creating and using skills

Community

WeChat Official Account
WeChat Official
Follow for updates
Personal WeChat
WeChat (Personal)
Note "OpenAkita" to join group
WeChat Group
WeChat Group
Scan to join (⚠️ refreshed weekly)
QQ Group
QQ Group: 854429727
Scan or search to join

Discord Β· X (Twitter) Β· Email

Issues Β· Discussions Β· Star


Acknowledgments

License

Apache License 2.0 β€” See LICENSE

Third-party licenses: THIRD_PARTY_NOTICES.md

Star History

Star History Chart

OpenAkita β€” Open-Source Multi-Agent AI Assistant That Gets Things Done

Pinned Loading

  1. openakita openakita Public

    An open-source AI assistant framework with skills and agent architecture

    Python 1k 118