Skip to main content

全能自进化AI Agent - 基于Ralph Wiggum模式,永不放弃

Project description

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

Personal WeChat QR Code
WeChat (Personal)
Scan to add, note "OpenAkita" to join group
WeChat Group QR Code
WeChat Group
Scan to join directly (⚠️ refreshed weekly)
WeChat — Scan to add friend (never expires), note "OpenAkita" to get invited

WeChat Group — Scan to join directly (QR refreshed weekly)

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

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openakita-1.20.7.tar.gz (9.9 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

openakita-1.20.7-py3-none-any.whl (835.8 kB view details)

Uploaded Python 3

File details

Details for the file openakita-1.20.7.tar.gz.

File metadata

  • Download URL: openakita-1.20.7.tar.gz
  • Upload date:
  • Size: 9.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.14

File hashes

Hashes for openakita-1.20.7.tar.gz
Algorithm Hash digest
SHA256 a4d37ecbaa27dc68ed0de27bf67e789ba23bab349ed0729a30fd4b91ee1e9b82
MD5 2f95c4fbbe64c0fe14683a1385c11d7b
BLAKE2b-256 27d9650465f9a1941826873b20af560a9b2008cd9e20d7b2d91789eff152de6d

See more details on using hashes here.

File details

Details for the file openakita-1.20.7-py3-none-any.whl.

File metadata

  • Download URL: openakita-1.20.7-py3-none-any.whl
  • Upload date:
  • Size: 835.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.14

File hashes

Hashes for openakita-1.20.7-py3-none-any.whl
Algorithm Hash digest
SHA256 0ca0c03c0774e6fa3cf919ee6f169111f0443f8d9f6f968a6ac7363dc21e7c88
MD5 2055f78058e4159aaf2363a184e44856
BLAKE2b-256 5a48343360003bbd143581ddd6af79a0992b11566d0aec4fd7ce124bee0f18d2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page