aas

一个基于 OpenAI tool-calling 的 CLI 智能体，可通过工具调用读写文件、执行代码。

安装

pip install aasai

装完在任何目录运行 aas 或 aas --web。更新用 pip install -U aasai。

Windows：装到系统 Python（官方安装器已把 Scripts 加入 PATH）时命令直接可用，无需额外配置；若用 pip install --user 避免污染系统环境，需一次性把 %APPDATA%\Python\Python314\Scripts 加入用户 PATH。备用入口 python -m aas.main 不依赖 PATH。

配置

配置文件为 ~/.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

发布

.\scripts\release.ps1 0.2.3

发布需要 .pypi-token（被 .gitignore 忽略）。

Metadata

Release files for aasai 0.2.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aasai 0.2.3
File	Size	Uploaded
aasai-0.2.3.tar.gz	46.8 kB	Aug 31, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for aasai 0.2.3
File	Interpreter	ABI	Platform	Reset
aasai-0.2.3-py3-none-any.whl 38.1 kB Aug 31, 2026	Python 3	none	any	Details

Total release size: 85.0 kB

Release files / aasai-0.2.3.tar.gz

Download URL	aasai-0.2.3.tar.gz
Size	46.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`01e2832754007f0bce845b2e31788c1a945f1679534d869d1f9714e68f4b2fcf`
BLAKE2b-256 checksum How to use checksums	`2c65cbf4dadd1e7853c7a995a9a085b9a809bc5cf07c62f94dcf5142a44a876c`
Upload date	Aug 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.4`

Release files / aasai-0.2.3-py3-none-any.whl

Download URL	aasai-0.2.3-py3-none-any.whl
Size	38.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`64f69e15b7402a4105f540e68bf1f11c9b6f68814218e225fc0f7da540e6d58d`
BLAKE2b-256 checksum How to use checksums	`d9546a25f1a4409bd47a594b3722dba87599f26847657190d5e5432e3563ef33`
Upload date	Aug 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.4`