viby 0.0.8

Viby agent at your terminal

Viby

Viby vibes everything

English | 中文

✨ Features

• Intelligent Conversations - Engage in natural multi-turn dialogues
• Command Generation - Get optimized shell commands with explanations
• Pipeline Integration - Process data from other commands (e.g., git diff | viby "write a commit message")
• MCP Tools - Extended capabilities through Model Context Protocol integration

🔧 Installation

# Install from PyPI
pip install viby

Alternative Installation

# Install from source with uv
uv pip install -e .

Usage Examples

Basic Question

yb "Write a quicksort in python"
# -> Sure! Here is a quicksort algorithm implemented in **Python**:

Interactive Chat Mode

yb -c
|> Tell me about quantum computing
# -> [AI responds about quantum computing]
|> What are the practical applications?
# -> [AI responds with follow-up information]

Process Piped Content

git diff | yb "Generate a commit message"
# -> Added information to the README

yb "What is this project about?" < README.md
# -> This project is about...

Generate Shell Command

yb -s "How many lines of python code did I write?"
# -> find . -type f -name "*.py" | xargs wc -l
# -> [r]run, [e]edit, [y]copy, [c]chat, [q]quit (default: run): 

Automatically Use MCP Tools When Needed

yb "What time is it now?"
# -> [AI uses time tool to get current time]
# -> "datetime": "2025-05-03T00:49:57+08:00"

Configuration

Viby reads configuration from ~/.config/viby/config.yaml. You can set the model, parameters, and MCP options here.

Interactive Configuration

Use the configuration wizard to set up your preferences:

yb --config

This allows you to configure:

• API endpoint and key
• Model
• Temperature and token settings
• MCP tools enablement
• Interface language

MCP Server Configuration

Viby supports Model Context Protocol (MCP) servers for extended capabilities. MCP configurations are stored in ~/.config/viby/mcp_servers.json.