Skip to main content

aas

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

安装

pip install aasai

装完在任何目录运行 aasaas --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-planARK_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

Download files

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

Source Distribution

aasai-0.2.0.tar.gz (34.2 kB view details)

Uploaded Source

Built Distribution

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

aasai-0.2.0-py3-none-any.whl (33.9 kB view details)

Uploaded Python 3

File details

Details for the file aasai-0.2.0.tar.gz.

File metadata

  • Download URL: aasai-0.2.0.tar.gz
  • Upload date:
  • Size: 34.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.4

File hashes

Hashes for aasai-0.2.0.tar.gz
Algorithm Hash digest
SHA256 24d4da16b2d2f0e4b20bb905f54f9cf6ddcebd795af51a460c8bf404beff210e
MD5 1e1ec4bc79cf9bcabe9255e32c6eb34d
BLAKE2b-256 c24e2184987757a7c1a67a274021905f9a62a2bc545200804eaa8cdf88a6f89c

See more details on using hashes here.

File details

Details for the file aasai-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: aasai-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 33.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.4

File hashes

Hashes for aasai-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 698efc1dd02117a5fe53869ce46d070cd13c77e61054a867483b64df2c100b80
MD5 9968cd8debbbfbc737a4a69094360376
BLAKE2b-256 797eb2502511fd144a496e8c7e76251f13900dc0e4828e83a1b0aa74196197ea

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 files

0.1.1

2 files

0.1.0

2 files

Supported by

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