# JVS CLI
A terminal-based AI chat interface with streaming support and beautiful terminal formatting.
## Features
- Interactive REPL mode with conversation history
- Streaming responses with real-time display
- AI thinking step visualization
- Markdown rendering
- Multiple color themes
- Support for multiple AI providers:
- Jarvis backend
- OpenAI (GPT-4 and other models)
- Anthropic Claude (Haiku 4.5 by default)
## Installation
```bash
pip install jvs-cli
```
## Quick Start
### Using Jarvis Backend
#### Predefined Environments
For quick access to Jarvis environments, use the predefined options:
**Local Development:**
```bash
# First time (will prompt for login code)
jvs-cli -local
# Subsequent uses
jvs-cli -local
```
**Beta Environment:**
```bash
jvs-cli -beta
```
**Production Environment:**
```bash
jvs-cli -prod
```
#### Custom Configuration
Initialize custom configuration:
```bash
jvs-cli config init
```
You'll be prompted for:
- API URL (OpenAI-compatible endpoint)
- Login Code
- Theme (color scheme)
Start chatting:
```bash
jvs-cli
```
### Using OpenAI
First time (with API key):
```bash
jvs-cli -openai -k sk-your-openai-api-key
```
Subsequent uses (key is saved):
```bash
jvs-cli -openai
```
Debug mode to see API responses:
```bash
jvs-cli -openai -d
```
### Using Claude
First time (with API key):
```bash
jvs-cli -claude -k your-anthropic-api-key
```
Subsequent uses (key is saved):
```bash
jvs-cli -claude
```
### One-shot Queries
With Jarvis:
```bash
jvs-cli ask "What is machine learning?"
```
With OpenAI:
```bash
jvs-cli ask "What is machine learning?" -openai
```
With Claude:
```bash
jvs-cli ask "What is machine learning?" -claude
```
## Commands
Interactive mode commands:
- `/new` - Start new conversation
- `/history` - Show conversation history
- `/config` - Show configuration
- `/help` - Show help
- `/exit` - Exit
CLI commands:
- `jvs-cli` - Interactive mode with default provider
- `jvs-cli -local` - Use local Jarvis environment
- `jvs-cli -beta` - Use beta Jarvis environment
- `jvs-cli -prod` - Use production Jarvis environment
- `jvs-cli -openai` - Use OpenAI API
- `jvs-cli -claude` - Use Claude API
- `jvs-cli ask "query"` - One-shot query
- `jvs-cli chat <conv_id>` - Continue conversation
- `jvs-cli config init` - Setup wizard
- `jvs-cli config show` - Show configuration
- `jvs-cli history` - List conversations
Environment options work with all commands:
```bash
jvs-cli ask "hello" -local
jvs-cli ask "hello" -beta
jvs-cli ask "hello" -prod
jvs-cli ask "hello" -openai
jvs-cli ask "hello" -claude
```
## Configuration
### Predefined Jarvis Environments
The following environments are built-in and don't require configuration:
- `-local`: `http://localhost:7961/api/v1` (Local development)
- `-beta`: `https://jvs-api.atomecorp.net/api/v1` (Beta environment)
- `-prod`: `https://jarvis-api.atomecorp.net/api/v1` (Production environment)
Config file: `~/.jvs-cli/config.json`
```json
{
"api_provider": "jarvis",
"api_base_url": "https://api.example.com/v1",
"login_code": "your_login_code",
"api_keys": {
"openai_api_key": "sk-...",
"claude_api_key": "sk-ant-..."
},
"display": {
"theme": "claude_dark",
"live_mode": true
}
}
```
API keys are stored locally and used automatically after first use.
## Requirements
- Python 3.10+
- OpenAI-compatible API endpoint
## License
Apache License 2.0
Raw data
{
"_id": null,
"home_page": null,
"name": "jvs-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "cli, chat, ai, terminal, streaming",
"author": "JVS CLI Contributors",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/df/2d/5b71286e5b2060c873dc1b439edede895388137a9f3c0e134c805f2b440a/jvs_cli-0.1.7.tar.gz",
"platform": null,
"description": "# JVS CLI\n\nA terminal-based AI chat interface with streaming support and beautiful terminal formatting.\n\n## Features\n\n- Interactive REPL mode with conversation history\n- Streaming responses with real-time display\n- AI thinking step visualization\n- Markdown rendering\n- Multiple color themes\n- Support for multiple AI providers:\n - Jarvis backend\n - OpenAI (GPT-4 and other models)\n - Anthropic Claude (Haiku 4.5 by default)\n\n## Installation\n\n```bash\npip install jvs-cli\n```\n\n## Quick Start\n\n### Using Jarvis Backend\n\n#### Predefined Environments\n\nFor quick access to Jarvis environments, use the predefined options:\n\n**Local Development:**\n```bash\n# First time (will prompt for login code)\njvs-cli -local\n\n# Subsequent uses\njvs-cli -local\n```\n\n**Beta Environment:**\n```bash\njvs-cli -beta\n```\n\n**Production Environment:**\n```bash\njvs-cli -prod\n```\n\n#### Custom Configuration\n\nInitialize custom configuration:\n\n```bash\njvs-cli config init\n```\n\nYou'll be prompted for:\n- API URL (OpenAI-compatible endpoint)\n- Login Code\n- Theme (color scheme)\n\nStart chatting:\n\n```bash\njvs-cli\n```\n\n### Using OpenAI\n\nFirst time (with API key):\n\n```bash\njvs-cli -openai -k sk-your-openai-api-key\n```\n\nSubsequent uses (key is saved):\n\n```bash\njvs-cli -openai\n```\n\nDebug mode to see API responses:\n\n```bash\njvs-cli -openai -d\n```\n\n### Using Claude\n\nFirst time (with API key):\n\n```bash\njvs-cli -claude -k your-anthropic-api-key\n```\n\nSubsequent uses (key is saved):\n\n```bash\njvs-cli -claude\n```\n\n### One-shot Queries\n\nWith Jarvis:\n\n```bash\njvs-cli ask \"What is machine learning?\"\n```\n\nWith OpenAI:\n\n```bash\njvs-cli ask \"What is machine learning?\" -openai\n```\n\nWith Claude:\n\n```bash\njvs-cli ask \"What is machine learning?\" -claude\n```\n\n## Commands\n\nInteractive mode commands:\n- `/new` - Start new conversation\n- `/history` - Show conversation history\n- `/config` - Show configuration\n- `/help` - Show help\n- `/exit` - Exit\n\nCLI commands:\n- `jvs-cli` - Interactive mode with default provider\n- `jvs-cli -local` - Use local Jarvis environment\n- `jvs-cli -beta` - Use beta Jarvis environment\n- `jvs-cli -prod` - Use production Jarvis environment\n- `jvs-cli -openai` - Use OpenAI API\n- `jvs-cli -claude` - Use Claude API\n- `jvs-cli ask \"query\"` - One-shot query\n- `jvs-cli chat <conv_id>` - Continue conversation\n- `jvs-cli config init` - Setup wizard\n- `jvs-cli config show` - Show configuration\n- `jvs-cli history` - List conversations\n\nEnvironment options work with all commands:\n```bash\njvs-cli ask \"hello\" -local\njvs-cli ask \"hello\" -beta\njvs-cli ask \"hello\" -prod\njvs-cli ask \"hello\" -openai\njvs-cli ask \"hello\" -claude\n```\n\n## Configuration\n\n### Predefined Jarvis Environments\n\nThe following environments are built-in and don't require configuration:\n\n- `-local`: `http://localhost:7961/api/v1` (Local development)\n- `-beta`: `https://jvs-api.atomecorp.net/api/v1` (Beta environment)\n- `-prod`: `https://jarvis-api.atomecorp.net/api/v1` (Production environment)\n\nConfig file: `~/.jvs-cli/config.json`\n\n```json\n{\n \"api_provider\": \"jarvis\",\n \"api_base_url\": \"https://api.example.com/v1\",\n \"login_code\": \"your_login_code\",\n \"api_keys\": {\n \"openai_api_key\": \"sk-...\",\n \"claude_api_key\": \"sk-ant-...\"\n },\n \"display\": {\n \"theme\": \"claude_dark\",\n \"live_mode\": true\n }\n}\n```\n\nAPI keys are stored locally and used automatically after first use.\n\n## Requirements\n\n- Python 3.10+\n- OpenAI-compatible API endpoint\n\n## License\n\nApache License 2.0\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Terminal-based AI chat interface with streaming support",
"version": "0.1.7",
"project_urls": null,
"split_keywords": [
"cli",
" chat",
" ai",
" terminal",
" streaming"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ff14fb7ed9e3a4035750b3d62a1e28b6d66df817f7a0d950ff9db48bc14160a1",
"md5": "85d854d4bbf33a872168eb1b02357f93",
"sha256": "ba1ccd8f0815bc0812804e3f1423b17686be949a252ef07f43cc7bacec39ed53"
},
"downloads": -1,
"filename": "jvs_cli-0.1.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "85d854d4bbf33a872168eb1b02357f93",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 30576,
"upload_time": "2025-10-28T10:34:52",
"upload_time_iso_8601": "2025-10-28T10:34:52.260396Z",
"url": "https://files.pythonhosted.org/packages/ff/14/fb7ed9e3a4035750b3d62a1e28b6d66df817f7a0d950ff9db48bc14160a1/jvs_cli-0.1.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "df2d5b71286e5b2060c873dc1b439edede895388137a9f3c0e134c805f2b440a",
"md5": "98d755d4ba27517caabd922bdb8fa379",
"sha256": "b6a0dbc44c1dcf3f7fa656e62112f94fabedbfa93b55e1cfaef33d747629700c"
},
"downloads": -1,
"filename": "jvs_cli-0.1.7.tar.gz",
"has_sig": false,
"md5_digest": "98d755d4ba27517caabd922bdb8fa379",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 29911,
"upload_time": "2025-10-28T10:34:53",
"upload_time_iso_8601": "2025-10-28T10:34:53.310383Z",
"url": "https://files.pythonhosted.org/packages/df/2d/5b71286e5b2060c873dc1b439edede895388137a9f3c0e134c805f2b440a/jvs_cli-0.1.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-28 10:34:53",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "jvs-cli"
}
JSON