Metadata-Version: 2.4
Name: vierrataleai
Version: 0.1.0b7
Summary: VierrataleAI - Intelligent terminal assistant
Author: Vierratale
License: MIT
Keywords: ai,chatbot,terminal,assistant,llm
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: rich>=13.0
Dynamic: requires-python

# VierrataleAI

Intelligent terminal assistant that runs AI models locally and in the cloud.

## Install

```bash
pip install vierrataleai
```

The first launch detects and, if needed, installs and starts the local engine
(**Cortex** - "secretly" Ollama under the hood), then pulls the model you use.

## Usage

```bash
vierrataleai                          # Start chat (auto-detect provider)
vierrataleai --provider cortex        # Use local models
vierrataleai --provider openai        # Use cloud models (OpenAI)
vierrataleai --provider anthropic     # Use cloud models (Claude)
vierrataleai --provider gemini        # Use cloud models (Gemini)
vierrataleai --model vierratale-pro   # Use specific model

# Or run as module
python -m vierrataleai
```

## Models

Local models run through the **Cortex** engine:

| Model | Backend |
|-------|---------|
| vierratale-lite | qwen3:0.6b |
| vierratale-fast | gemma3:1b |
| vierratale-small | llama3.2:1b |
| vierratale-balanced | qwen2.5:1.5b |
| vierratale-plus | qwen3:1.7b |
| vierratale-pro | qwen2.5:3b |

Cloud models are available when the matching provider + API key is configured:

| Model | Backend |
|-------|---------|
| vierratale-cloud-mini | gpt-4o-mini (OpenAI) |
| vierratale-cloud | gpt-4o (OpenAI) |
| vierratale-cloud-fast | claude-3-5-haiku-20241022 (Anthropic) |
| vierratale-cloud-pro | claude-sonnet-4-20250514 (Anthropic) |
| vierratale-cloud-lite | gemini-2.0-flash (Gemini) |
| vierratale-cloud-plus | gemini-1.5-pro (Gemini) |

## Commands

- `/help` - Show commands
- `/model [name]` - Switch model
- `/provider [name]` - Switch provider
- `/models` - List available models
- `/system [text]` - Set a custom system prompt / persona
- `/search <query>` - Search the web and summarize with AI
- `/clear` - Clear screen
- `/new` - Start a new conversation (clear memory)
- `/quit` - Exit

## Smart Search

Asking a question (Who/What/When/Where/Why/How...?) automatically searches the
web and summarizes the results with AI. For example:

```
> Who is Cristiano Ronaldo?
```

triggers a live web search and answers from the results. Use `/search <query>`
to force a search explicitly.

## Conversation Memory

Your conversation is saved automatically and restored on the next launch, so
you can continue where you left off. Use `/new` to start fresh.

## Configuration

Config file: `~/.config/vierrataleai/config.json`

Environment variables:
- `VIERRATALE_PROVIDER` - Default provider (auto/cortex/openai/anthropic/gemini)
- `VIERRATALE_MODEL` - Default model
- `OPENAI_API_KEY` - OpenAI API key (openai provider)
- `ANTHROPIC_API_KEY` - Anthropic API key (anthropic provider)
- `GEMINI_API_KEY` - Google AI API key (gemini provider)

## Build Standalone Binary

```bash
./build.sh
# Output: dist/vierrataleai
```

## License

MIT
