aas
一个基于 OpenAI tool-calling 的轻量 CLI 智能体，可通过工具调用读写文件、执行代码。
定位
| 是 | 不是 |
|---|---|
| 信任 AI、方便第一 | 防备 AI、安全优先 |
| 一句话提示词 + 通用工具 | 几万字工具定义 + 受限工具 |
| 极简、单用户、个人工具 | 重武器、多用户、通用产品 |
价值在"轻"，不在"功能多"。任何增加重量的优化，都是对它的背叛。 期待被更简单的方案吞噬——被吞噬是成功，不是失败。
安装
| 步骤 | 命令 | 说明 |
|---|---|---|
| 1 | pip install pipx |
装 pipx（已有则跳过） |
| 2 | pipx install git+https://gitee.com/ma-xiaodun/ass.git |
从 Gitee 装 aas + 全部依赖 |
| 3 | 见下方 | Windows 配置 PATH；macOS/Linux 跳过 |
Windows 第三步（在 PowerShell 执行，然后重开终端）：
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", $userPath + ";$env:USERPROFILE\.local\bin", "User")
装完在任何目录运行 aas 或 aas --web。更新用 pipx upgrade aas。
配置
配置文件为 ~/.aas/config.json（用户目录，与源码分离）。首次使用前创建：
{
"MODEL": "deepseek-chat",
"DEEPSEEK_API_KEY": "你的密钥",
"DEEPSEEK_BASE_URL": "https://api.deepseek.com/v1",
"DEEPSEEK_MODELS": "deepseek-chat"
}
MODEL：当前模型名（必设，须在某供应商{P}_MODELS中登记）- 每个供应商三项：
{P}_API_KEY/{P}_BASE_URL/{P}_MODELS（模型名逗号分隔） P= 供应商名大写、连字符转下划线，如ark-plan→ARK_PLAN
使用
终端模式：
aas
启动后输入内容对话；exit 退出。会话命令：/new 新会话、/list 列出、/switch N 切换、/model 切换默认模型。
Web 界面模式：
aas --web
浏览器打开 http://127.0.0.1:8765，获得带 Markdown 渲染、流式输出、工具调用可见、会话切换的聊天界面。
开发者
pip install -e . # 可编辑安装，改代码即生效
- 配置与会话存于
~/.aas/，与源码分离，删除源码不影响数据。 - 新增工具：新建
aas/tools/xxx.py→ 在aas/tools/__init__.py加一行 → 生效。 - 设计决策遵循 CONSTITUTION.md。
依赖
- Python >= 3.11
- openai
- pydantic
- ipython
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file aasai-0.1.0.tar.gz.
File metadata
- Download URL: aasai-0.1.0.tar.gz
- Upload date:
- Size: 32.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b31054b7e4a51426c78187789c77be8222d01df687f5c38982360babea0a114d
|
|
| MD5 |
714c5f22b25728cb88fcfaa219ab6e99
|
|
| BLAKE2b-256 |
3ea58aa0aee31f3a62ab796b3cef7337cee083595d687585c04b23e951e01312
|
File details
Details for the file aasai-0.1.0-py3-none-any.whl.
File metadata
- Download URL: aasai-0.1.0-py3-none-any.whl
- Upload date:
- Size: 33.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6151d8365969c75554c78f0e18c85598be232b8f49254908fc634e6cc143cb3b
|
|
| MD5 |
5738400e9622d871faf84f224d844af1
|
|
| BLAKE2b-256 |
72de7f4478fabbcfc61d0c9484916dd06b5d77ee45bfb0753ddd6b54dd3f3c01
|
