klyro 1.0.8

 ██╗  ██╗██╗  ██╗   ██╗██████╗  ██████╗
 ██║ ██╔╝██║  ╚██╗ ██╔╝██╔══██╗██╔═══██╗
 █████╔╝ ██║   ╚████╔╝ ██████╔╝██║   ██║
 ██╔═██╗ ██║    ╚██╔╝  ██╔══██╗██║   ██║
 ██║  ██╗███████╗██║   ██║  ██║╚██████╔╝
 ╚═╝  ╚═╝╚══════╝╚═╝   ╚═╝  ╚═╝ ╚═════╝

⚡ Quick Start

pip install klyro

Optional features are installed explicitly:

pip install "klyro[voice]"       # microphone transcription
pip install "klyro[tui]"         # experimental full terminal UI
pip install "klyro[playwright]"  # browser automation

# Run with your API key set
klyro

# Or specify a model directly
klyro --model gpt-4o
klyro --model ollama/llama3.2
klyro --model gemini/gemini-2.5-flash

Windows: If klyro is not recognized, either run python -m klyro or add your Scripts folder to PATH:

python -c "import sysconfig; print(sysconfig.get_path('scripts', 'nt_user'))"

Install from source:

git clone https://github.com/RavindraTirlangi/Klyro.git
cd Klyro
pip install -e .

✨ Features

/model                              → list current provider's models
/model search coder                 → search current provider
/model openrouter/deepseek/deepseek-r1:free
/model ollama/qwen2.5-coder:latest

🧠 Supported Models

Klyro discovers models from the provider currently in use instead of shipping a fixed model catalogue:

• OpenRouter: models allowed by the authenticated account's preferences, privacy settings, and guardrails.
• Ollama: models installed on the local machine.
• Other providers: current text/chat models registered by LiteLLM.

Run /model to see the current provider's models, then switch with the exact identifier shown. Optional personal aliases can be configured with --alias.

💬 Slash Commands

Klyro provides 43 built-in slash commands to manage your files, models, git repository, and session:

📁 File & Context Management

🛠️ Coding, Testing & Shell

🧠 Model Configuration

🐙 Git Integration

🎙️ Session & Input Helpers

⌨️ Keyboard Shortcuts

Klyro provides Emacs-style keybindings for prompt editing and history navigation:

Prompt Editing & Navigation

• Ctrl + A : Move cursor to the start of the line.
• Ctrl + E : Move cursor to the end of the line.
• Ctrl + B : Move cursor back one character.
• Ctrl + F : Move cursor forward one character.
• Ctrl + D : Delete the character under the cursor.
• Ctrl + K : Cut/delete from the cursor to the end of the line.
• Ctrl + Y : Paste (yank) text that was previously cut.
• Ctrl + L : Clear the terminal screen.

History Navigation

• Ctrl + R : Search backwards through your sent message history.
• Ctrl + P / Ctrl + Up : Scroll back to previous history entries.
• Ctrl + N / Ctrl + Down : Scroll forward to next history entries.
• Up Arrow : Move cursor up one line inside a multiline message.
• Down Arrow : Move cursor down one line inside a multiline message.

Multiline & Cancellation

• Alt + Enter (or Ctrl + J) : Submit message in multiline mode.
• { on a line by itself : Start a bracket-based multiline prompt.
• } on a line by itself : Submit a bracket-based multiline prompt.
• Ctrl + C : Abort the current prompt or cancel an interactive question (returns to prompt).

⚙️ Configuration

Create .klyro.conf.yml in your project root:

model: ollama/llama3.2   # default model
dark-mode: true
auto-commits: true

Or use environment variables:

# Cloud providers
export OPENAI_API_KEY=sk-...
export ANTHROPIC_API_KEY=sk-ant-...
export GEMINI_API_KEY=...
export DEEPSEEK_API_KEY=...
export MISTRAL_API_KEY=...
export XAI_API_KEY=...
export GROQ_API_KEY=...
export OPENROUTER_API_KEY=sk-or-...

# Local
export OLLAMA_API_BASE=http://localhost:11434

📦 Release

Tagged releases automatically publish to PyPI via GitHub Actions:

git tag vX.Y.Z
git push origin vX.Y.Z

Publishing is gated by tests, package validation, and a clean wheel install/startup/uninstall smoke test.

See CHANGELOG.md for full version history.

📄 License

Apache License 2.0 — see LICENSE for details.