cometapi-cli 0.1.0__py3-none-any.whl

cometapi_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,228 @@
+Metadata-Version: 2.4
+Name: cometapi-cli
+Version: 0.1.0
+Summary: CometAPI CLI — official command-line interface for the CometAPI AI gateway
+Project-URL: Homepage, https://github.com/CometAPI/cometapi-cli
+Project-URL: Repository, https://github.com/CometAPI/cometapi-cli
+Project-URL: Documentation, https://docs.cometapi.com
+Project-URL: Changelog, https://github.com/CometAPI/cometapi-cli/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/CometAPI/cometapi-cli/issues
+Author-email: CometAPI <support@cometapi.com>
+License: MIT
+License-File: LICENSE
+Keywords: ai,api-gateway,chat,cli,cometapi,llm,openai,streaming
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: openai>=1.0.0
+Requires-Dist: prompt-toolkit>=3.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: tomli-w>=1.0
+Requires-Dist: tomli>=2.0; python_version < '3.11'
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# CometAPI CLI
+
+[![PyPI](https://img.shields.io/pypi/v/cometapi-cli)](https://pypi.org/project/cometapi-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/cometapi-cli)](https://pypi.org/project/cometapi-cli/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+> **Official command-line interface for [CometAPI](https://cometapi.com)** — 500+ AI Model API, All In One API.
+
+Access 500+ AI models at low cost, directly from the terminal. Chat, search models, check usage, and manage your account — all through a single API key.
+
+**Features**: multi-model chat (streaming + REPL) · model search · account & usage stats · diagnostics · multi-format output (table/JSON/YAML/CSV/Markdown) · agent-native design · TOML config · shell completion
+
+## Installation
+
+```bash
+pip install cometapi-cli
+```
+
+```bash
+pipx install cometapi-cli    # isolated environment
+uv tool install cometapi-cli  # uv
+```
+
+**Prerequisites**: Python 3.10+ · [Get your API key](https://www.cometapi.com/console/token)
+
+## Quick Start
+
+```bash
+# 1. Run the setup wizard
+cometapi init
+
+# 2. Chat with a model
+cometapi chat "Explain quantum computing in one sentence"
+
+# 3. List available models
+cometapi models --search gpt --limit 10
+```
+
+Or configure manually:
+
+```bash
+export COMETAPI_KEY="your-api-key"               # https://www.cometapi.com/console/token
+export COMETAPI_ACCESS_TOKEN="your-access-token"  # https://www.cometapi.com/console/personal (optional)
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `chat [MESSAGE]` | Send a message or start interactive chat REPL (no args) |
+| `models` | List available models (`--search`, `--limit`) |
+| `balance` | Show account balance |
+| `account` | Show account profile (requires access token) |
+| `stats` | Show usage statistics (requires access token) |
+| `tokens` | List and search your API keys (requires access token) |
+| `logs` | Show usage logs with filters (requires access token) |
+| `tasks` | Show async task logs (requires access token) |
+| `init` | Interactive setup wizard |
+| `doctor` | Run diagnostics and health checks |
+| `repl` | Start interactive command shell |
+| `config` | Manage CLI configuration (`show`, `set`, `unset`, `path`) |
+
+### Chat
+
+```bash
+cometapi chat "Hello!"                                          # Streaming
+cometapi chat "Summarize this" --model claude-sonnet-4-6 --system "Be concise"
+cometapi chat "Hello" --json                                    # JSON output
+cometapi chat                                                   # Interactive REPL
+```
+
+**Chat REPL commands**: `/model`, `/system`, `/clear`, `/history`, `/save`, `/tokens`, `/help`, `/exit`
+
+### Models
+
+```bash
+cometapi models                        # List all
+cometapi models --search claude        # Search by name
+cometapi models --limit 5 --json       # JSON output
+```
+
+### Logs
+
+```bash
+cometapi logs                          # Recent usage logs
+cometapi logs --model gpt-5.4         # Filter by model
+cometapi logs --start 2026-04-01       # Date filter
+cometapi logs --export > usage.csv     # CSV export
+cometapi logs --limit 50 --json        # JSON output
+```
+
+### Tasks
+
+```bash
+cometapi tasks                         # Recent task logs
+cometapi tasks --platform suno         # Filter by platform
+cometapi tasks --status SUCCESS        # Filter by status
+cometapi tasks --json                  # JSON output
+```
+
+### Output Formats
+
+All data commands support `--json` or `--format`:
+
+```bash
+cometapi models --json
+cometapi models --format yaml
+cometapi stats --format csv
+cometapi account --format markdown
+```
+
+### Shell Completion
+
+```bash
+cometapi --install-completion
+```
+
+## Configuration
+
+Config file: `~/.config/cometapi/config.toml`
+
+```bash
+cometapi config show              # View current config
+cometapi config set api_key sk-…  # Set a value
+cometapi config unset api_key     # Remove a value
+cometapi config path              # Show config file path
+```
+
+**Priority**: CLI flags > config file > environment variables > defaults
+
+| Key | Env Variable | Description |
+|-----|-------------|-------------|
+| `api_key` | `COMETAPI_KEY` | API key (required) |
+| `access_token` | `COMETAPI_ACCESS_TOKEN` | Access token for account commands |
+| `base_url` | `COMETAPI_BASE_URL` | API base URL |
+| `default_model` | `COMETAPI_DEFAULT_MODEL` | Default model (fallback: `gpt-5.4`) |
+| `output_format` | — | Default output format (`table`, `json`, `yaml`, `csv`, `markdown`) |
+
+## Agent Integration
+
+CometAPI CLI is designed to be agent-friendly:
+
+- All data commands support `--json` for structured, machine-readable output
+- Deterministic exit codes (0=success, 64=config missing, 77=auth error, 69=service unavailable)
+- Errors on stderr, data on stdout
+- See [SKILL.md](SKILL.md) for the full agent skill definition
+
+## Development
+
+```bash
+git clone https://github.com/CometAPI/cometapi-cli.git
+cd cometapi-cli
+uv sync --extra dev
+
+uv run pytest -v              # tests
+uv run ruff check src/ tests/ # lint
+uv run cometapi --version     # verify
+```
+
+<details>
+<summary>Without uv (pip)</summary>
+
+```bash
+git clone https://github.com/CometAPI/cometapi-cli.git
+cd cometapi-cli
+pip install -e ".[dev]"
+pytest -v
+```
+
+</details>
+
+## Security
+
+- API keys and access tokens are **never** logged or displayed in full — only the last 4 characters are shown
+- Config files are stored with restrictive permissions (`0600`)
+- Credentials should **never** be committed to version control
+- Create credentials at: [API Key](https://www.cometapi.com/console/token) · [Access Token](https://www.cometapi.com/console/personal)
+- **Disclaimer**: You are responsible for all usage and charges incurred with your API keys
+
+## Troubleshooting
+
+| Error | Solution |
+|-------|----------|
+| `API key not configured` | Run `cometapi init` or set `COMETAPI_KEY` env var |
+| `Connection failed` | Run `cometapi doctor` to diagnose connectivity |
+| `Access token not configured` | Only needed for `account`/`stats` commands — run `cometapi init` to add one |
+
+## License
+
+MIT

cometapi_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,27 @@
+cometapi_cli/__init__.py,sha256=lv0NDx348LemOymOagNAd60v2BIPG3JVB5L7unHswJU,92
+cometapi_cli/app.py,sha256=0rUJ975zKApr5Htr1pVoAUgFUi0TXqYVFV8Z6MEUG6Y,2743
+cometapi_cli/client.py,sha256=4JkMSrjWwAQV8tmlwplZQ75gzt3zHno8ASKLgMCpYkU,9658
+cometapi_cli/config.py,sha256=oJXQidKCOsKNYPnE8OfLLoOfsv0MSZEDICB6VShJRSA,3307
+cometapi_cli/console.py,sha256=HFSU1gL9SDmwjBvgVgDraoaU50oTwCRpsAwYXYlVP9o,163
+cometapi_cli/constants.py,sha256=EV2i-ag4ss1xGrU1CLiF9iPz8ggzNm4-U3wpYCC2pys,1601
+cometapi_cli/errors.py,sha256=MQ3VXefVhdIFa4uUmoLf_O5d1EFuu9PfGYrBGuq-mSA,3703
+cometapi_cli/formatters.py,sha256=QrXpsQHRYiJ49Rwz_7dOMoKxCcnRPumZMrxH21ZQaMw,4573
+cometapi_cli/main.py,sha256=4NmO8MAAc_H30hahT6VNrdGdlaFlQ99AixKcRV5iDXE,168
+cometapi_cli/commands/__init__.py,sha256=mihzLmD4ADkH9WnCBP2p1fn95lU3GyzTliAJ1XL5Ngg,29
+cometapi_cli/commands/account.py,sha256=OGPRaNwiQ0IdSajiR1XV0NAYSYftvK4tZVYBCNMjQWQ,1222
+cometapi_cli/commands/balance.py,sha256=xGvHu3LXMqfcWUHRj4hHkV_NSJG_Mdzj0RTV-TTIG2s,1798
+cometapi_cli/commands/chat.py,sha256=4XqzaQzKwU00YYR0RAMYcjnqZKU3vKmUFDZxe2ml854,3856
+cometapi_cli/commands/chat_repl.py,sha256=b9lkYnbbaOb0AlSpRcq3wWHmnhtTXvaqeJiUImsMEBY,8176
+cometapi_cli/commands/config_cmd.py,sha256=W_TAHlti9AbeSdvEiXA9dy3p5-ckXm80HHzwJ8I2d3g,5953
+cometapi_cli/commands/doctor.py,sha256=Ue8uDi1TaZ1BJhIwveOuZhhyBw0Hob4XEerS6WBoYkw,5302
+cometapi_cli/commands/logs.py,sha256=O4tdtazEgWP2pl0T0a4oDsi1aV6mVkxR-BH_V-2ZZPM,11377
+cometapi_cli/commands/models.py,sha256=pUblCx3HBzOyskQJ7cfgxa-SCEHX73pVjSxHckEEr0A,1297
+cometapi_cli/commands/repl.py,sha256=foKPox6Hn3iEjh_nftnRWpvVjsNx0ZngSPhKDbKpViA,4295
+cometapi_cli/commands/stats.py,sha256=LfmmQX5iTJkkEvcg-NOjQRRjUXueUazMSnwz9YwazLs,1353
+cometapi_cli/commands/tasks.py,sha256=9gArl6qOhyG0T47KNdOjx44-vKQiI2cf1CYQQiW_k9k,4539
+cometapi_cli/commands/tokens.py,sha256=H74PFD5nYiwZrdP1PHxRevyfWtzIttfORundudCPjOc,2984
+cometapi_cli-0.1.0.dist-info/METADATA,sha256=ckfVsPTkEUfWW4zbcAsQC7nwAgTJF4m5dYZOLVjxqmQ,7637
+cometapi_cli-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+cometapi_cli-0.1.0.dist-info/entry_points.txt,sha256=xoiE2ZVNNWXTq0JRBtzC8hJ2JkdKuaBNz_fEd8OJpLs,50
+cometapi_cli-0.1.0.dist-info/licenses/LICENSE,sha256=-rBwHQzkmLbty07abmGvQvsRrvDeEQUkPDhNJfTcjdE,1065
+cometapi_cli-0.1.0.dist-info/RECORD,,

cometapi_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

cometapi_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+cometapi = cometapi_cli.app:app

cometapi_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CometAPI
+
+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.