Arka 简介

Arka 是一款跨平台 AI 终端代理，可将简明英语请求路由到 70+ 个本地技能，支持语音回复以及离线符号化路由。

Arka 是一款面向终端的跨平台 AI 代理。用简明英语说出你的需求 —— Arka 会将请求路由到合适的本地技能，运行它，并在你需要时用语音把答案念给你听。

命令在本地运行。LLM 调用通过回退编排器分发到 24 个提供商 —— 日常使用无需 Docker。

​

无需从源码构建即可安装

你不需要克隆或编译 Arka 即可在终端使用。用 pipx 或 pip 安装发布包：

pipx install "arka-agent[chat]"
arka setup
arka doctor
arka ask "what is Rust?"

若 PyPI 尚未上线，可直接从 GitHub 安装（仍无需本地构建）：

pipx install "arka-agent[chat] @ git+https://github.com/Sumit884-byte/arka.git"

详见快速开始。

快速开始

用 pipx 安装 —— 无需 git clone —— 五分钟内运行第一条命令。

如何用 Arka 写代码

终端编码工作流 —— 设置、编辑、审查、CI 与 IDE 集成。

技能目录

70+ 个内置技能，覆盖媒体、网络、文档、系统、开发和金融。

路由

大多数请求通过离线符号规则实现零 LLM token 消耗。

安全

提示注入拦截、风险操作提示、破坏性 shell 命令硬拦截。

​

Arka 能做什么

arka ask "what is Rust?"
arka "convert 100 USD to INR"
arka youtube research "python asyncio tutorial"
arka stock invest "where to invest 3000 for 1 month"
arka goal set up a venv and run pytest
arka listen    # "hey arka, what's the weather"

​

核心能力

• 70+ 本地技能 —— 媒体、网络、PDF RAG、Google Workspace、图表、股票、YouTube、语音
• 离线优先路由 —— 120+ 条符号规则；仅在必要时调用 LLM
• 24 提供商 LLM 故障切换 —— Gemini、Groq、OpenAI、Anthropic、Ollama、vLLM、OpenRouter 等
• 语音 —— 唤醒词监听、多轮对话、TTS 回复
• 安全网关 —— 默认开启
• 插件 —— 通过 skill.json 触发器扩展

​

平台模式

平台	模式
全平台 (macOS, Windows, Linux)	通过 pip + fish shell 获得完整 70+ 技能
无 fish	便携式 Python：chat、web、calc、weather、插件
Linux + fish 登录 shell	完整技能 + 语音自启 + systemd 单元

​

文档导航

​

使用 Arka

CLI 参考

命令、别名和子命令

技能目录

完整的内置技能列表

​

对话与搜索

对话与网络答案

网络搜索、计算、天气、地图

记忆

Supermemory 和本地召回

​

文档与媒体

PDF RAG

摄取和查询 PDF

图表

Matplotlib PNG 图表

视觉

图片、蓝图、屏幕截取

YouTube

研究、下载、批量

​

集成与金融

Google Workspace

Gmail 与日历

插件

第三方 skill.json 扩展

股票情报

市场新闻、基本面、情绪

​

代理与运维

语音

唤醒词、STT、TTS

目标代理

自主多步骤任务

专业领域

来源可追溯的领域答案

可观测性

SigNoz 与 OpenTelemetry

测试

pytest 测试套件

配置

环境变量与默认值

基于 GPL-2.0 开源。PyPI 包：arka-agent。