AiChat CLI
A command-line tool for AI Dialogue via the AceDataCloud platform.
Features
- Chat with AI — Send questions to GPT, DeepSeek, Grok, GLM, and more models
- Conversation Continuation — Resume conversations using
--id - Stateful Sessions — Enable multi-turn context with
--stateful - References — Inject context documents into prompts with
--ref - Rich Output — Beautiful terminal formatting with
--jsonfor scripting - Many Models — GPT-5, GPT-4o, o3, o4-mini, DeepSeek, Grok, GLM, and more
Installation
pip install aichat-pro-cli
Quick Start
# Set your API token
export ACEDATACLOUD_API_TOKEN=your_token_here
# Ask a question
aichat chat "What is the capital of France?"
# Use a specific model
aichat chat "Explain quantum computing" -m gpt-4o
# Continue a conversation
aichat chat "Tell me more" --id 64a67fff-61dc-4801-8339-2c69334c61d6
# Stateful conversation (server remembers context)
aichat chat "My name is Alice" --stateful
aichat chat "What is my name?" --id <returned-id> --stateful
# With reference documents
aichat chat "Summarize this" --ref "https://example.com/doc.txt"
# Get JSON output
aichat chat "Hello" --json | jq '.answer'
Commands
| Command | Description |
|---|---|
chat |
Send a question to an AI model (/aichat/conversations) |
chat2 |
Send a conversation request with structured messages and tool results (/aichat2/conversations) |
models |
List all available models |
models2 |
List models available to chat2 |
config |
Show current configuration |
Chat Options
| Option | Description |
|---|---|
-m, --model |
Model to use (default: gpt-4o) |
--id |
Conversation ID to continue |
--preset |
Preset model name |
--stateful |
Enable stateful conversation |
--ref |
Reference URL or text (repeatable) |
--json |
Output raw JSON |
Configuration
| Environment Variable | Description | Default |
|---|---|---|
ACEDATACLOUD_API_TOKEN |
API authentication token | (required) |
ACEDATACLOUD_API_BASE_URL |
API base URL | https://api.acedata.cloud |
AICHAT_REQUEST_TIMEOUT |
Request timeout in seconds | 30 |
You can also use a .env file or pass --token directly.
Docker
docker compose run aichat-cli chat "Hello!"
Development
# Install with dev dependencies
pip install -e ".[all]"
# Run tests
pytest
# Run linter
ruff check .
ruff format --check .
License
MIT License - see LICENSE for details.
Links
1 maintainer
Metadata
1 maintainer
Release files for aichat-pro-cli 2026.10.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aichat_pro_cli-2026.10.6.0.tar.gz | 14.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aichat_pro_cli-2026.10.6.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 27.3 kB
Release files / aichat_pro_cli-2026.10.6.0.tar.gz
| Download URL | aichat_pro_cli-2026.10.6.0.tar.gz |
|---|---|
| Size | 14.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
aa8b9d2a618908199fc6d381c13b66d895259c39f018062e70f3a380e506a434
|
|
BLAKE2b-256 checksum How to use checksums |
fd79a45627de1592eecf52fb1205bcef3f602bcebdeb8b29c2551348f40472ef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / aichat_pro_cli-2026.10.6.0-py3-none-any.whl
| Download URL | aichat_pro_cli-2026.10.6.0-py3-none-any.whl |
|---|---|
| Size | 13.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9e5f95c612ad488eef120f718e958942a05ec0862b8ebc738e760eac305d2a62
|
|
BLAKE2b-256 checksum How to use checksums |
562e988b70cf13c7d0fbea5d12bba1ff6ce4a35352eac2d6499ba963b6708696
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
