aichat-pro-cli 2026.8.11.0__tar.gz

aichat_pro_cli-2026.8.11.0/.env.example

@@ -0,0 +1,9 @@
+# AceDataCloud API Token
+# Get yours at https://platform.acedata.cloud
+ACEDATACLOUD_API_TOKEN=
+
+# Optional: Custom API base URL (default: https://api.acedata.cloud)
+# ACEDATACLOUD_API_BASE_URL=https://api.acedata.cloud
+
+# Optional: Request timeout in seconds (default: 30)
+# AICHAT_REQUEST_TIMEOUT=30

aichat_pro_cli-2026.8.11.0/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.1.0] - 2025-04-25
+
+### Added
+
+- Initial release of AiChat CLI
+- `chat` command to send questions to large language models
+- `models` command to list all available models
+- `config` command to show current configuration
+- Support for conversation continuation via `--id`
+- Support for stateful conversations via `--stateful`
+- Support for references/context documents via `--ref`
+- Support for preset models via `--preset`
+- `--json` flag for machine-readable output on all commands
+- Rich terminal formatting for human-readable output
+- Docker support via Dockerfile and docker-compose.yaml

aichat_pro_cli-2026.8.11.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AceDataCloud
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aichat_pro_cli-2026.8.11.0/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.1
+Name: aichat-pro-cli
+Version: 2026.8.11.0
+Summary: CLI tool for AI Dialogue (aichat) via AceDataCloud API
+Project-URL: Homepage, https://github.com/AceDataCloud/AichatCli
+Project-URL: Repository, https://github.com/AceDataCloud/AichatCli
+Project-URL: Issues, https://github.com/AceDataCloud/AichatCli/issues
+Project-URL: Changelog, https://github.com/AceDataCloud/AichatCli/blob/main/CHANGELOG.md
+Author-email: AceDataCloud <support@acedata.cloud>
+Maintainer-email: AceDataCloud <support@acedata.cloud>
+License: MIT
+License-File: LICENSE
+Keywords: acedata,ai,aichat,chat,cli,command-line,gpt,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: all
+Requires-Dist: aichat-pro-cli[dev,release,test]; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Provides-Extra: release
+Requires-Dist: build>=1.2.0; extra == 'release'
+Requires-Dist: twine>=6.1.0; extra == 'release'
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'test'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'test'
+Requires-Dist: pytest>=8.0.0; extra == 'test'
+Requires-Dist: respx>=0.21.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# AiChat CLI
+
+A command-line tool for AI Dialogue via the [AceDataCloud](https://platform.acedata.cloud) 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 `--json` for scripting
+- **Many Models** — GPT-5, GPT-4o, o3, o4-mini, DeepSeek, Grok, GLM, and more
+
+## Installation
+
+```bash
+pip install aichat-pro-cli
+```
+
+## Quick Start
+
+```bash
+# 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`) |
+| `models` | List all available models |
+| `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
+
+```bash
+docker compose run aichat-cli chat "Hello!"
+```
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[all]"
+
+# Run tests
+pytest
+
+# Run linter
+ruff check .
+ruff format --check .
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Links
+
+- [AceDataCloud Platform](https://platform.acedata.cloud)
+- [API Documentation](https://docs.acedata.cloud)

aichat_pro_cli-2026.8.11.0/README.md

@@ -0,0 +1,102 @@
+# AiChat CLI
+
+A command-line tool for AI Dialogue via the [AceDataCloud](https://platform.acedata.cloud) 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 `--json` for scripting
+- **Many Models** — GPT-5, GPT-4o, o3, o4-mini, DeepSeek, Grok, GLM, and more
+
+## Installation
+
+```bash
+pip install aichat-pro-cli
+```
+
+## Quick Start
+
+```bash
+# 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`) |
+| `models` | List all available models |
+| `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
+
+```bash
+docker compose run aichat-cli chat "Hello!"
+```
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[all]"
+
+# Run tests
+pytest
+
+# Run linter
+ruff check .
+ruff format --check .
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Links
+
+- [AceDataCloud Platform](https://platform.acedata.cloud)
+- [API Documentation](https://docs.acedata.cloud)

aichat_pro_cli-2026.8.11.0/aichat_cli/__init__.py

@@ -0,0 +1 @@
+"""AiChat CLI - AI Dialogue via AceDataCloud API."""

aichat_pro_cli-2026.8.11.0/aichat_cli/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as python -m aichat_cli."""
+
+from aichat_cli.main import cli
+
+cli()

aichat_pro_cli-2026.8.11.0/aichat_cli/commands/__init__.py

@@ -0,0 +1 @@
+"""AiChat CLI commands package."""

aichat_pro_cli-2026.8.11.0/aichat_cli/commands/chat.py

@@ -0,0 +1,312 @@
+"""Chat command."""
+
+import json
+
+import click
+
+from aichat_cli.core.client import get_client
+from aichat_cli.core.exceptions import AichatError
+from aichat_cli.core.output import (
+    ACTIONS2,
+    DEFAULT_MODEL,
+    DEFAULT_MODEL2,
+    MODEL_GROUPS,
+    MODELS,
+    MODELS2,
+    print_answer,
+    print_error,
+    print_json,
+)
+
+
+def _parse_json_option(value: str | None, param_hint: str) -> dict | list | None:
+    """Parse a JSON string option, raising BadParameter on invalid JSON."""
+    if value is None:
+        return None
+    try:
+        return json.loads(value)
+    except json.JSONDecodeError as exc:
+        raise click.BadParameter("Must be a valid JSON string.", param_hint=param_hint) from exc
+
+
+@click.command()
+@click.argument("question")
+@click.option(
+    "-m",
+    "--model",
+    default=DEFAULT_MODEL,
+    type=click.Choice(MODELS, case_sensitive=True),
+    help=f"Model to use (default: {DEFAULT_MODEL}).",
+    show_default=True,
+)
+@click.option(
+    "--id",
+    "conversation_id",
+    default=None,
+    help="Conversation ID to continue an existing conversation.",
+)
+@click.option(
+    "--preset",
+    default=None,
+    help="Preset model name.",
+)
+@click.option(
+    "--stateful",
+    is_flag=True,
+    default=False,
+    help="Enable stateful conversation (server remembers context).",
+)
+@click.option(
+    "--ref",
+    "references",
+    multiple=True,
+    help="Reference URL or text to include as context (can be repeated).",
+)
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def chat(
+    ctx: click.Context,
+    question: str,
+    model: str,
+    conversation_id: str | None,
+    preset: str | None,
+    stateful: bool,
+    references: tuple[str, ...],
+    output_json: bool,
+) -> None:
+    """Send a question to an AI model and get an answer.
+
+    QUESTION is the prompt or question to send to the model.
+
+    \b
+    Examples:
+      aichat chat "What is the capital of France?"
+      aichat chat "Explain AI" -m gpt-4o
+      aichat chat "Tell me more" --id 64a67fff-61dc-4801-8339-2c69334c61d6
+      aichat chat "My name is Alice" --stateful
+      aichat chat "Summarize this" --ref "https://example.com/doc.txt"
+    """
+    client = get_client(ctx.obj.get("token"))
+    try:
+        payload: dict[str, object] = {
+            "question": question,
+            "model": model,
+            "id": conversation_id,
+            "preset": preset,
+            "stateful": stateful if stateful else None,
+            "references": list(references) if references else None,
+        }
+
+        result = client.converse(**payload)  # type: ignore[arg-type]
+        if output_json:
+            print_json(result)
+        else:
+            print_answer(result)
+    except AichatError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e
+
+
+@click.command(name="chat2")
+@click.argument("question", required=False, default=None)
+@click.option(
+    "-m",
+    "--model",
+    default=DEFAULT_MODEL2,
+    type=click.Choice(MODELS2, case_sensitive=True),
+    help=f"Model to use (default: {DEFAULT_MODEL2}).",
+    show_default=True,
+)
+@click.option(
+    "--action",
+    default="chat",
+    type=click.Choice(ACTIONS2),
+    help="Action to perform (default: chat).",
+    show_default=True,
+)
+@click.option(
+    "--id",
+    "conversation_id",
+    default=None,
+    help="Conversation ID to continue an existing conversation.",
+)
+@click.option(
+    "--preset",
+    default=None,
+    help="Preset model name.",
+)
+@click.option(
+    "--stateful/--no-stateful",
+    default=None,
+    help="Enable or disable stateful conversation (omitted by default; server default: true).",
+)
+@click.option(
+    "--ref",
+    "references",
+    multiple=True,
+    help="Reference URL or text to include as context (can be repeated).",
+)
+@click.option(
+    "--model-group",
+    default=None,
+    type=click.Choice(MODEL_GROUPS),
+    help="Model group to use (e.g. chatgpt, claude, gemini).",
+)
+@click.option(
+    "--max-turns",
+    default=None,
+    type=click.IntRange(min=1),
+    help="Maximum number of conversation turns.",
+)
+@click.option(
+    "--title",
+    default=None,
+    help="Title for the conversation.",
+)
+@click.option(
+    "--user-id",
+    default=None,
+    help="User ID for the conversation.",
+)
+@click.option(
+    "--callback-url",
+    default=None,
+    help="Callback URL for async results.",
+)
+@click.option(
+    "--async-mode",
+    "async_mode",
+    is_flag=True,
+    default=False,
+    help="Enable asynchronous processing.",
+)
+@click.option(
+    "--application-id",
+    default=None,
+    help="Application ID for the conversation.",
+)
+@click.option(
+    "--allowed-skill",
+    "allowed_skills",
+    multiple=True,
+    help="Allowed skill name (can be repeated).",
+)
+@click.option(
+    "--allowed-mcp-server",
+    "allowed_mcp_servers",
+    multiple=True,
+    help="Allowed MCP server name (can be repeated).",
+)
+@click.option(
+    "--offset",
+    default=None,
+    type=click.IntRange(min=0),
+    help="Offset for paginated retrieval (minimum: 0).",
+)
+@click.option(
+    "--limit",
+    default=None,
+    type=click.IntRange(min=1, max=100),
+    help="Limit for paginated retrieval (1-100).",
+)
+@click.option(
+    "--message",
+    default=None,
+    help="Single message value as a JSON string (alternative to --question for complex message types).",
+)
+@click.option(
+    "--messages",
+    default=None,
+    help='Conversation messages as a JSON array, e.g. \'[{"role":"user","content":"Hello"}]\'.',
+)
+@click.option(
+    "--tool-results",
+    default=None,
+    help='Tool call results as a JSON array, e.g. \'[{"tool_use_id":"id","output":"result"}]\'.',
+)
+@click.option(
+    "--unattended-policy",
+    default=None,
+    help=(
+        "Unattended agent policy as a JSON object, "
+        'e.g. \'{"allowed_skills":["web_search"],"allowed_mcp_servers":[],"expires_at":1790000000}\'.'
+    ),
+)
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def chat2(
+    ctx: click.Context,
+    question: str | None,
+    model: str,
+    action: str,
+    conversation_id: str | None,
+    preset: str | None,
+    stateful: bool | None,
+    references: tuple[str, ...],
+    model_group: str | None,
+    max_turns: int | None,
+    title: str | None,
+    user_id: str | None,
+    callback_url: str | None,
+    async_mode: bool,
+    application_id: str | None,
+    allowed_skills: tuple[str, ...],
+    allowed_mcp_servers: tuple[str, ...],
+    offset: int | None,
+    limit: int | None,
+    message: str | None,
+    messages: str | None,
+    tool_results: str | None,
+    unattended_policy: str | None,
+    output_json: bool,
+) -> None:
+    """Send a question or conversation payload to an AI model via the aichat2 endpoint.
+
+    QUESTION is an optional prompt or question to send to the model.
+    Omit it for actions like retrieve, or when sending structured payloads
+    with --message or --messages.
+
+    \b
+    Examples:
+      aichat chat2 "What is the capital of France?"
+      aichat chat2 "Explain AI" -m claude-sonnet-5
+      aichat chat2 "Tell me more" --id 64a67fff-61dc-4801-8339-2c69334c61d6
+      aichat chat2 "Summarize this" --ref "https://example.com/doc.txt" --model-group claude
+      aichat chat2 "Hello" --allowed-skill web_search --allowed-mcp-server my-server
+      aichat chat2 --action retrieve --id 64a67fff-61dc-4801-8339-2c69334c61d6
+    """
+    client = get_client(ctx.obj.get("token"))
+    try:
+        payload: dict[str, object] = {
+            "question": question,
+            "model": model,
+            "action": action,
+            "id": conversation_id,
+            "preset": preset,
+            "stateful": stateful,
+            "references": list(references) if references else None,
+            "model_group": model_group,
+            "max_turns": max_turns,
+            "title": title,
+            "user_id": user_id,
+            "application_id": application_id,
+            "callback_url": callback_url,
+            "async": async_mode if async_mode else None,
+            "allowed_skills": list(allowed_skills) if allowed_skills else None,
+            "allowed_mcp_servers": list(allowed_mcp_servers) if allowed_mcp_servers else None,
+            "offset": offset,
+            "limit": limit,
+            "message": _parse_json_option(message, "--message"),
+            "messages": _parse_json_option(messages, "--messages"),
+            "tool_results": _parse_json_option(tool_results, "--tool-results"),
+            "unattended_policy": _parse_json_option(unattended_policy, "--unattended-policy"),
+        }
+
+        result = client.converse2(**payload)  # type: ignore[arg-type]
+        if output_json:
+            print_json(result)
+        else:
+            print_answer(result)
+    except AichatError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e

aichat_pro_cli-2026.8.11.0/aichat_cli/commands/info.py

@@ -0,0 +1,37 @@
+"""Info and utility commands."""
+
+import click
+
+from aichat_cli.core.config import settings
+from aichat_cli.core.output import console, print_models, print_models2
+
+
+@click.command()
+def models() -> None:
+    """List all available AI models for /aichat/conversations."""
+    print_models()
+
+
+@click.command()
+def models2() -> None:
+    """List all available AI models for /aichat2/conversations."""
+    print_models2()
+
+
+@click.command()
+def config() -> None:
+    """Show current configuration."""
+    from rich.table import Table
+
+    table = Table(title="AiChat CLI Configuration")
+    table.add_column("Setting", style="bold cyan")
+    table.add_column("Value")
+
+    table.add_row("API Base URL", settings.api_base_url)
+    table.add_row(
+        "API Token",
+        f"{settings.api_token[:8]}..." if settings.api_token else "[red]Not set[/red]",
+    )
+    table.add_row("Request Timeout", f"{settings.request_timeout}s")
+
+    console.print(table)

aichat_pro_cli-2026.8.11.0/aichat_cli/core/__init__.py

@@ -0,0 +1 @@
+"""AiChat CLI core package."""