enkaliprime-cli 0.6.0

Command-line interface for EnkaliPrime Chat API

🖥️ EnkaliPrime CLI

Beautiful Command-Line Interface for AI Chat

Chat with AI directly from your terminal with rich formatting and beautiful animations

---

Installation • Quick Start • Commands • Examples

---

✨ Features

💬 Interactive AI Chat Real-time conversation with AI assistants Rich markdown formatting for responses Beautiful Unicode animations while thinking Session persistence across chats	🏠 Local LLM Support Ollama integration for local AI models Zero API costs for local inference Privacy-focused - conversations stay local Multiple model support (Llama2, CodeLlama, Mistral, etc.)
🎨 Beautiful Terminal UI Rich console output with colors and formatting Loading animations with brain emoji sequences Interactive prompts with validation Progress indicators and status displays	🔐 Secure Configuration Encrypted API key storage using system keyring Automatic validation of API keys Connection testing to verify setup Ollama model configuration and management
📝 Session Management Create named sessions for different contexts Session history and conversation tracking Multiple agents support Clean session lifecycle management	🎯 Smart Provider Switching Automatic provider detection and switching Fallback mechanisms for reliability Unified interface for local and remote AI Simple --local flag for easy local LLM access

---

🏗️ Architecture

graph TD
    A[🖥️ Terminal] --> B[enkaliprime CLI]
    B --> C{Commands}
    C --> D[💬 chat]
    C --> E[⚙️ config]
    C --> F[📝 session]

    D --> G[Interactive Chat]
    D --> H[Single Message]
    D --> I[History View]

    E --> J[API Key Config]
    E --> K[Ollama Config]
    E --> L[Test Connection]
    E --> M[Show Config]

    F --> N[Create Session]
    F --> O[End Session]
    F --> P[Session Info]

    B --> Q[🔐 Keyring]
    B --> R[📦 SDK]
    R --> S{Provider Router}
    S --> T[🤖 EnkaliPrime API]
    S --> U[🏠 Local Ollama]

    Q --> V[(API Keys)]
    Q --> W[(Ollama Models)]

---

📦 Installation

From PyPI (Recommended)

pip install enkaliprime-cli

From Source

git clone https://github.com/enkaliprime/enkaliprime-cli.git
cd enkaliprime-cli
pip install -e .

Requirements

• Python 3.8+
• enkaliprime SDK (automatically installed)
• System keyring support (built-in on most systems)
• Optional: Ollama for local LLM support

---

🏠 Local LLM Support (Ollama)

EnkaliPrime CLI supports local AI models through Ollama integration, allowing you to run AI conversations without API costs and with complete privacy.

Quick Local Setup

1. Install Ollama:

   # Download from https://ollama.ai/
   # Or use package manager:
   # Linux: curl -fsSL https://ollama.ai/install.sh | sh
   # macOS: brew install ollama
   # Windows: winget install Ollama.Ollama
   

2. Start Ollama:

   ollama serve
   

3. Pull a model:

   ollama pull llama2      # General purpose
   ollama pull codellama   # Code assistant
   ollama pull mistral     # Fast and capable
   

4. Configure CLI:

   enkaliprime config set-ollama-model
   # Interactive model selection
   

5. Start using local AI:

   enkaliprime chat interactive --local
   enkaliprime chat ask "Hello local AI!" --local
   

Local vs Remote Comparison

Feature	Remote (EnkaliPrime)	Local (Ollama)
Cost	API usage fees	Free (one-time setup)
Privacy	Cloud processing	Local processing
Speed	Network dependent	Local inference
Models	Curated selection	Any Ollama model
Setup	API key only	Ollama installation
Offline	❌ Requires internet	✅ Works offline

---

🚀 Quick Start

Option A: Remote AI (EnkaliPrime API)

1. Configure API Key

enkaliprime config set-api-key
# Follow the secure prompt to enter your API key

2. Test Connection

enkaliprime config test-connection
# Verify everything is working

3. Start Chatting

enkaliprime chat interactive
# Begin your AI conversation!

Option B: Local AI (Ollama)

1. Install and Setup Ollama

# Install Ollama (visit https://ollama.ai/)
ollama serve
ollama pull llama2

2. Configure Default Model

enkaliprime config set-ollama-model
# Interactive model selection from available Ollama models

3. Start Local Chat

enkaliprime chat interactive --local
# Chat with your local AI model!

Hybrid Usage

You can use both remote and local AI:

# Remote AI (default)
enkaliprime chat interactive

# Local AI (when configured)
enkaliprime chat interactive --local

# Check available providers
enkaliprime chat providers

---

📖 Commands

Main Commands

Command	Description
enkaliprime --help	Show help and available commands
enkaliprime info	Show CLI information and features
enkaliprime --version	Show version information

💬 Chat Commands

Command	Description
enkaliprime chat interactive	Start interactive chat session (remote AI)
enkaliprime chat interactive --local	Start interactive chat with local Ollama model
enkaliprime chat ask "message"	Send single message and get response
enkaliprime chat ask "message" --local	Send message to local Ollama model
enkaliprime chat providers	List available AI providers and models
enkaliprime chat history	Show conversation history

⚙️ Configuration Commands

Command	Description
enkaliprime config set-api-key	Set your EnkaliPrime API key securely
enkaliprime config get-api-key	Show masked API key
enkaliprime config remove-api-key	Remove stored API key
enkaliprime config test-connection	Test EnkaliPrime API connection
enkaliprime config set-ollama-model	Configure default Ollama model
enkaliprime config get-ollama-model	Show current Ollama model setting
enkaliprime config remove-ollama-model	Remove Ollama model configuration
enkaliprime config show-ollama	Show Ollama status and available models
enkaliprime config show	Show current configuration

📝 Session Commands

Command	Description
enkaliprime session create	Create new chat session
enkaliprime session current	Show current session info
enkaliprime session end	End current session
enkaliprime session list	List all sessions
enkaliprime session clear-history	Clear conversation history

---

💡 Examples

Interactive Chat Session

# Remote AI with custom agent
enkaliprime chat interactive --agent "Code Assistant"

# Local AI with configured Ollama model
enkaliprime chat interactive --local

# Local AI with specific model override
enkaliprime chat interactive --local --model codellama

# Remote AI without loading animations
enkaliprime chat interactive --no-loading

Single Message Queries

# Remote AI - quick question
enkaliprime chat ask "What is the capital of France?"

# Local AI - private, no-cost query
enkaliprime chat ask "Explain quantum computing" --local

# Local AI with specific model
enkaliprime chat ask "Write a Python function" --local --model codellama

# Remote AI with custom agent
enkaliprime chat ask "Explain recursion" --agent "Programming Tutor"

Configuration Management

# EnkaliPrime API Configuration
enkaliprime config set-api-key
enkaliprime config test-connection
enkaliprime config show

# Ollama Local AI Configuration
enkaliprime config set-ollama-model     # Interactive model selection
enkaliprime config get-ollama-model     # Show current model
enkaliprime config show-ollama          # Show Ollama status & models
enkaliprime config remove-ollama-model  # Remove model config

# Provider Management
enkaliprime chat providers              # List available AI providers

Session Management

# Create a new session with custom agent
enkaliprime session create --name "Math Tutor" --avatar "🎓"

# Check current session
enkaliprime session current

# End the current session
enkaliprime session end

# Clear conversation history
enkaliprime session clear-history

---

🔧 Troubleshooting

Command Not Found Error

If you get "enkaliprime" command not found after installation:

Windows (PowerShell/Command Prompt)

Check if Python Scripts directory is in PATH:

where python
# This should show your Python installation directory

Add Python Scripts to PATH (run as Administrator):

setx PATH "%PATH%;C:\Python313\Scripts"  # Replace with your Python version

Or use full path:

& "C:\Users\%USERNAME%\AppData\Roaming\Python\Python313\Scripts\enkaliprime.exe" --help

Linux/macOS

Check PATH:

echo $PATH
which python3

Add to PATH in ~/.bashrc or ~/.zshrc:

export PATH="$HOME/.local/bin:$PATH"  # For user installations
# OR
export PATH="/usr/local/bin:$PATH"     # For system installations

Alternative Usage

Use Python module directly (recommended for PowerShell):

python -m enkaliprime_cli info
python -c "from enkaliprime_cli.main import app; import sys; sys.argv = ['enkaliprime', 'chat', 'interactive']; app()"

Use pipx for isolated installation:

pip install pipx
pipx install enkaliprime-cli
# Now enkaliprime command works globally

PowerShell Compatibility

If you experience glitches with loading animations in PowerShell:

1. Disable progress display:

   $ProgressPreference = "SilentlyContinue"
   enkaliprime chat ask "Hello"
   

2. Use Python directly:

   python -c "from enkaliprime_cli.main import app; import sys; sys.argv = ['enkaliprime', 'chat', 'ask', 'Hello']; app()"
   

3. Loading animations are disabled by default in CLI commands to avoid PowerShell conflicts. The SDK still shows its internal brain animation.

Ollama Setup Issues

"Ollama not available" error:

1. Install Ollama:

   # Visit https://ollama.ai/ for installation instructions
   # Windows: winget install Ollama.Ollama
   # macOS: brew install ollama
   # Linux: curl -fsSL https://ollama.ai/install.sh | sh
   

2. Start Ollama service:

   ollama serve
   # Keep this running in a separate terminal
   

3. Pull a model:

   ollama pull llama2  # General purpose model
   ollama pull codellama  # Code-focused model
   

4. Configure CLI:

   enkaliprime config set-ollama-model
   # Select your preferred model
   

Test Ollama connection:

enkaliprime config show-ollama
# Should show available models and ✅ status

Common Ollama issues:

• Port conflict: Default port 11434 may be in use
• Memory: Large models need sufficient RAM
• Storage: Models require disk space (2-7GB each)

API Key Issues

"No API key configured" error:

enkaliprime config set-api-key
# Enter your API key when prompted

Test connection:

enkaliprime config test-connection

---

🔐 Security

• Encrypted Storage: API keys are stored securely using your system's keyring
• No Plain Text: Keys are never displayed in full, only masked
• Secure Prompts: Password-style input for sensitive information
• Validation: Automatic format checking for API keys
• Local AI Privacy: Ollama models process conversations locally with zero data transmission

Best Practices

# ✅ Good: Use interactive setup
enkaliprime config set-api-key

# ❌ Bad: Expose key in command history
enkaliprime config set-api-key --key ek_bridge_secret_key

---

🎨 Terminal Features

Rich Formatting

• Markdown rendering for AI responses
• Syntax highlighting for code blocks
• Colored output for better readability
• Unicode emojis for visual appeal

Loading Animations

🧠 Thinking... 1.2s
🧠 Thinking... 2.8s
💭 Thinking... 3.1s
💡 Thinking... 3.7s
✨ Thinking... 4.2s

Interactive Prompts

• Auto-completion for commands and options
• Input validation with helpful error messages
• Confirmation prompts for destructive operations

---

🛠️ Development

Setup for Development

git clone https://github.com/enkaliprime/enkaliprime-cli.git
cd enkaliprime-cli
pip install -e ".[dev]"

Running Tests

pytest

Code Quality

# Format code
black enkaliprime_cli

# Sort imports
isort enkaliprime_cli

# Type checking
mypy enkaliprime_cli

# Linting
ruff enkaliprime_cli

---

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

---

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

---

🔗 Links

Resource	Link
📖 Documentation	api.enkaliprime.com/docs
🏠 Website	api.enkaliprime.com
📦 PyPI	pypi.org/project/enkaliprime-cli
🐙 GitHub	github.com/enkaliprime/enkaliprime-cli

---

Built with ❤️ by the EnkaliPrime Team

_{© 2024 EnkaliPrime. All rights reserved.}