LLM API（必需，至少配置一个）

什么是 OpenAkita？

OpenAkita 是一个自进化 AI Agent 框架。它能自主学习新技能、每日自检修复、从任务执行中积累经验，并在遇到困难时永不放弃——持续尝试直到任务完成。

就像它名字来源的秋田犬一样：忠诚、可靠、永不言弃。

• 自主进化 — 自动生成技能、安装依赖、从错误中学习
• 永不放弃 — Ralph Wiggum 模式：持续执行循环，任务未完成不会终止
• 记忆成长 — 记住你的偏好和习惯，每日自动整理记忆
• 标准化集成 — 遵循 MCP 和 Agent Skills 标准，生态兼容性强
• 全中文支持 — 从桌面终端到 IM 通道、LLM 服务商，完整的中文生态

桌面终端：AI 助手 + 一站式管理

OpenAkita 提供跨平台的 桌面终端 应用（基于 Tauri + React），集 AI 聊天、配置管理、状态监控于一体：

• AI 聊天助手 — 流式对话、Markdown 渲染、多模态输入、Thinking 展示、Plan 模式
• 中英文双语 — 自动识别系统语言，一键切换，全面国际化
• 简易流程配置 — 9 步引导式配置，精简聚焦，弹窗式 LLM 端点管理
• 中国本土化 — 国内 LLM 服务商一等支持、PyPI 镜像源、中文 IM 通道
• LLM 端点管理 — 多服务商、多端点、主备自动切换、在线拉取模型列表
• IM 通道配置 — Telegram、飞书、企业微信、钉钉、QQ 一站式配置
• 角色 & 活人感 — 8 种预设角色，主动问候、记忆回忆，越用越懂你
• 技能市场 — 浏览、下载、配置技能，一站式管理
• 状态监控 — 紧凑面板：服务/LLM/IM 健康状态一屏展示
• 后台常驻 — 系统托盘 + 开机自启动，一键启动/停止

下载安装包：GitHub Releases

支持 Windows (.exe) / macOS (.dmg) / Linux (.deb / .AppImage)

核心特性

真人化角色系统

OpenAkita 最具特色的能力——不只是工具，更像一个有性格、有记忆、有温度的真人助理：

效果展示：Agent 会在你空闲时主动问候，记住你的生日、喜好、工作习惯，像一个真正的朋友。

自学习与自进化

OpenAkita 的核心差异：不只是工具，而是会自主学习和成长的 Agent。

中国本土化 & 国际化

OpenAkita 生于中国，服务全球——为中文开发者量身打造，对国内用户提供一等公民级支持：

中国本土化（开箱即用）

• 全中文桌面终端 — 从安装到聊天，全程中文界面，自动识别系统语言
• 国内 LLM 服务商 — 阿里通义千问、月之暗面 Kimi、MiniMax、DeepSeek、硅基流动，直接可用
• 国内镜像加速 — 内置清华 TUNA、阿里云 PyPI 源，零配置加速依赖安装
• 中文 IM 通道 — 飞书、企业微信、钉钉、QQ 开箱即用
• 中文桌面自动化 — 支持中文自然语言描述 UI 元素（如"点击保存按钮"）
• 中文人格角色 — 贾维斯、虚拟女友/男友、家人、管家等角色，地道中文性格定义

国际化（i18n）

• 基于 react-i18next，中/英双语，后续可扩展更多语言
• 系统语言自动检测 + 一键手动切换
• LLM 服务商覆盖 Anthropic、OpenAI、Google Gemini 等国际主流

推荐模型

复杂任务建议开启 Thinking 模式。将模型设为 *-thinking 版本（如 claude-opus-4-5-20251101-thinking）可获得更好的推理效果。

快速开始

方式一：OpenAkita Desktop（推荐）

最简单的安装方式，图形化引导，无需命令行经验：

1. 从 GitHub Releases 下载对应平台安装包
2. 安装并启动 OpenAkita Desktop
3. 按向导完成：工作区 → Python → 安装 → LLM 端点 → IM 通道 → 完成并启动

方式二：PyPI 安装

# 安装
pip install openakita

# 安装全部可选功能
pip install openakita[all]

# 运行配置向导
openakita init

可选功能包：feishu（飞书）、whisper（语音识别）、browser（浏览器自动化）、windows（桌面自动化）

方式三：源码安装

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

运行

# 交互式 CLI
openakita

# 执行单个任务
openakita run "创建一个带测试的 Python 计算器"

# 服务模式（IM 通道）
openakita serve

# 后台守护进程
openakita daemon start

# 查看状态
openakita status

基本配置

# .env 文件（最小配置）

# LLM API（必需，至少配置一个）
ANTHROPIC_API_KEY=your-api-key

# Telegram（可选）
TELEGRAM_ENABLED=true
TELEGRAM_BOT_TOKEN=your-bot-token

# 飞书（可选）
FEISHU_ENABLED=true
FEISHU_APP_ID=your-app-id
FEISHU_APP_SECRET=your-app-secret

架构

┌─────────────────────────────────────────────────────────────────┐
│                          OpenAkita                               │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ┌──────────────────── 桌面终端 ──────────────────────────────┐   │
│  │  Tauri + React · AI 聊天 · 配置管理 · 状态监控 · 技能市场 │   │
│  └──────────────────────────────────────────────────────────┘   │
│                              │                                   │
│  ┌──────────────────── 身份层 ──────────────────────────────┐   │
│  │  SOUL.md(灵魂) · AGENT.md(行为) · USER.md(用户) · MEMORY.md │
│  │  Personas(8 种预设 + 用户自定义人格)                       │   │
│  └──────────────────────────────────────────────────────────┘   │
│                              │                                   │
│  ┌──────────────────── 核心层 ──────────────────────────────┐   │
│  │  Brain(LLM) · Identity(身份) · Memory(记忆) · Ralph(循环) │   │
│  │  Prompt Compiler(提示词编译) · Task Monitor(任务监控)      │   │
│  │  PersonaManager(人格) · TraitMiner(偏好挖掘) · Proactive(活人感) │
│  └──────────────────────────────────────────────────────────┘   │
│                              │                                   │
│  ┌──────────────────── 工具层 ──────────────────────────────┐   │
│  │  Shell · File · Web · MCP · Skills · Scheduler            │   │
│  │  Browser · Desktop · Plan · Profile · IM Channel          │   │
│  │  Persona(人格切换) · Sticker(表情包)                      │   │
│  └──────────────────────────────────────────────────────────┘   │
│                              │                                   │
│  ┌──────────────────── 进化引擎 ────────────────────────────┐   │
│  │  SelfCheck(自检) · Generator(技能生成) · Installer(自动安装)│   │
│  │  LogAnalyzer(日志分析) · DailyConsolidator(记忆整理)       │   │
│  └──────────────────────────────────────────────────────────┘   │
│                              │                                   │
│  ┌──────────────────── 通道层 ──────────────────────────────┐   │
│  │  CLI · Telegram · 飞书 · 企业微信 · 钉钉 · QQ            │   │
│  └──────────────────────────────────────────────────────────┘   │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

核心组件

文档

社区

加入社区，获取帮助、分享经验、参与讨论：

• 文档 — 完整使用指南
• Issues — Bug 报告与功能请求
• Discussions — 技术讨论与问答
• Star 项目 — 支持我们

致谢

• Anthropic Claude — 核心 LLM 引擎
• Tauri — 桌面终端跨平台框架
• browser-use — AI 浏览器自动化
• AGENTS.md Standard — Agent 行为规范标准
• Agent Skills — 技能标准化规范
• ZeroMQ — 多 Agent 进程间通信
• ChineseBQB — 中文表情包资源库

许可证

MIT License — 详见 LICENSE

本项目包含 Apache 2.0 等开源许可证下的第三方技能。详见 THIRD_PARTY_NOTICES.md。