VierrataleAI

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

Install

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

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:

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

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

./build.sh
# Output: dist/vierrataleai

License

MIT