Skip to content
View openakita's full-sized avatar
  • Joined Jan 30, 2026

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

Self-Evolving AI Agent — Learns Autonomously, Never Gives Up

License Python Version Version PyPI Build Status

Desktop TerminalFeaturesQuick StartArchitectureDocumentation

English | 中文


What is OpenAkita?

An AI Agent that keeps getting smarter while you sleep.

Most AI assistants forget you the moment the chat ends. OpenAkita teaches itself new skills, fixes its own bugs, and remembers everything you've told it — like the Akita dog it's named after: loyal, reliable, never quits.

Set up in 3 minutes with just an API key. 8 personas, 6 IM platforms, and yes — it sends memes.


Desktop Terminal

OpenAkita Desktop Terminal

OpenAkita provides a cross-platform Desktop Terminal (built with Tauri + React) — an all-in-one AI assistant with chat, configuration, monitoring, and skill management:

  • AI Chat Assistant — Streaming output, Markdown rendering, multimodal input, Thinking display, Plan mode
  • Bilingual (CN/EN) — Auto-detects system language, one-click switch, fully internationalized
  • Localization & i18n — First-class support for Chinese and international ecosystems, PyPI mirrors, IM channels
  • LLM Endpoint Manager — Multi-provider, multi-endpoint, auto-failover, online model list fetching
  • IM Channel Setup — Telegram, Feishu, WeCom, DingTalk, QQ Official Bot, OneBot — all in one place
  • Persona & Living Presence — 8 role presets, proactive greetings, memory recall, learns your preferences
  • Skill Marketplace — Browse, download, configure skills in one place
  • Status Monitor — Compact dashboard: service/LLM/IM health at a glance
  • System Tray — Background residency + auto-start on boot, one-click start/stop

Download: GitHub Releases

Available for Windows (.exe) / macOS (.dmg) / Linux (.deb / .AppImage)

3-Minute Quick Setup — Zero to Chatting

No command line. No config files. From install to conversation in 3 minutes:

OpenAkita Quick Setup vs Full Setup

Quick Setup (Recommended for new users)

① Fill in  → Add LLM endpoint + IM (optional)
② One-click → Auto-create env, install deps, write config
③ Done      → Launch service, start chatting

Just one API Key, everything else is automatic:

  • Auto-create workspace
  • Auto-download & install Python 3.11
  • Auto-create venv + pip install
  • Auto-write 40+ recommended defaults
  • Auto-save IM channel settings

Full Setup (Power users)

Workspace → Python → Install → LLM Endpoints
→ IM Channels → Tools & Skills → Agent System → Finish

8-step guided wizard with full control:

  • Custom workspaces (multi-env isolation)
  • Choose Python version & install source
  • Configure desktop automation, MCP tools
  • Tune persona, living presence parameters
  • Logging, memory, scheduler & more

Switch between modes anytime — click "Switch Setup Mode" in the sidebar to return to the selection page without losing existing configuration.

See Configuration Guide for full details.


Features

Feature In One Line
1 Self-Learning & Evolution Daily self-check, memory consolidation, task retrospection, auto skill generation — it gets smarter while you sleep
2 8 Personas + Living Presence Girlfriend / Butler / Jarvis… not just role-play — proactive greetings, remembers your birthday, auto-mutes at night
3 3-Min Quick Setup Desktop app, one-click start — just drop in an API Key, Python/env/deps/config all automatic
4 Plan Mode Complex tasks auto-decomposed into multi-step plans, real-time tracking, Plan → Act → Verify loop until done
5 Dynamic Multi-LLM 9+ providers hot-swappable, priority routing + auto-failover, one goes down, next picks up seamlessly
6 Skill + MCP Standards Agent Skills / MCP open standards, one-click GitHub skill install, plug-and-play ecosystem
7 7 IM Platforms Telegram / Feishu / WeCom / DingTalk / QQ Official Bot / OneBot / CLI — wherever you are, it's there
8 AI That Sends Memes Probably the first AI Agent that "meme-battles" — 5700+ stickers, mood-aware, persona-matched (powered by ChineseBQB)

How Does It Keep Getting Smarter?

Other AIs forget you the moment you close the chat. OpenAkita self-evolves — while you sleep, it's learning:

Every day 03:00  →  Memory consolidation: semantic dedup, extract insights, refresh MEMORY.md
Every day 04:00  →  Self-check: analyze error logs → LLM diagnosis → auto-fix → report
After each task   →  Retrospection: analyze efficiency, extract lessons, store long-term
When stuck        →  Auto-generate skills + install dependencies — it won't be stuck next time
Every chat turn   →  Mine your preferences and habits — gets to know you over time

Example: You ask it to write Python, it finds a missing package — auto pip install. Needs a new tool — auto-generates a Skill. Next morning, it's already fixed yesterday's bugs.


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 — just add -thinking suffix to the model name (e.g., claude-opus-4-5-20251101-thinking).


Quick Start

Option 1: Desktop App (Recommended)

The easiest way — download, drop in an API Key, click, done:

  1. Download from GitHub Releases (Windows / macOS / Linux)
  2. Install and launch OpenAkita Desktop
  3. Choose Quick Setup → Add LLM endpoint → Click "Start Setup" → All automatic → Start chatting

Need full control? Choose Full Setup: Workspace → Python → Install → LLM → IM → Tools → Agent → Finish

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 daemon start                 # Background daemon
openakita status                       # Check status

Minimum Config

# .env (just two lines to get started)
ANTHROPIC_API_KEY=your-api-key     # Or DASHSCOPE_API_KEY, etc.
TELEGRAM_BOT_TOKEN=your-bot-token  # Optional — connect Telegram

Architecture

Desktop App (Tauri + React)
    │
Identity ─── SOUL.md · AGENT.md · USER.md · MEMORY.md · 8 Persona Presets
    │
Core     ─── Brain(LLM) · Memory(Vector) · Ralph(Never-Give-Up Loop)
    │        Prompt Compiler · PersonaManager · ProactiveEngine
    │
Tools    ─── Shell · File · Web · Browser · Desktop · MCP · Skills
    │        Scheduler · Plan · Sticker · Persona
    │
Evolution ── SelfCheck · Generator · Installer · LogAnalyzer
    │        DailyConsolidator
    │
Channels ─── CLI · Telegram · Feishu · WeCom · DingTalk · QQ Official · OneBot

See Architecture Doc for full details.


Documentation

Document Content
Configuration Guide Desktop Quick Setup & Full Setup walkthrough
LLM Provider Setup API Key registration + endpoint config + multi-endpoint Failover
IM Channel Setup Telegram / Feishu / DingTalk / WeCom / QQ Official Bot / OneBot step-by-step tutorial
Quick Start Installation and basics
Architecture System design and components
Configuration All config options
Deployment Production deployment (systemd / Docker)
IM Channels Reference IM channels technical reference (media matrix / architecture)
MCP Integration Connecting external services
Skill System Creating and using skills

Community

WeChat Group QR Code
WeChat Group
Scan to join
WeChat — Chinese community

DiscordJoin Discord

X (Twitter)@openakita

Emailzacon365@gmail.com

Issues · Discussions · Star


Acknowledgments

License

MIT License — See LICENSE

Third-party licenses: THIRD_PARTY_NOTICES.md


OpenAkita — Self-Evolving AI Agent That Sends Memes, Learns Autonomously, Never Gives Up

Pinned Loading

  1. openakita openakita Public

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

    Python 74 6