Skip to main content

A multifunctional command-line tool for interacting with large language models.

Project description

viby

GitHub Repo PyPI version Python Version License: GPL v3 UV MCP

English | 中文 A multifunctional command-line tool for interacting with large language models.

Features

  • Ask questions and get AI-generated answers
  • Interactive chat mode for multi-turn conversations
  • Generate shell commands and explanations
  • Process piped input (e.g., content from git diff)
  • Support for OpenAI-compatible API interfaces

Installation

pip install viby

OR install from source

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): 

Use MCP Tools

yb -t "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.json. You can set the model and parameters here.

MCP Server Configuration

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

Language Switching

Viby defaults to an English interface. On first launch or with the --config argument, you can enter an interactive configuration wizard to select Chinese or other supported languages.

  • Default language: English (en-US)

Example:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

viby-0.0.6.tar.gz (35.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

viby-0.0.6-py3-none-any.whl (42.5 kB view details)

Uploaded Python 3

File details

Details for the file viby-0.0.6.tar.gz.

File metadata

  • Download URL: viby-0.0.6.tar.gz
  • Upload date:
  • Size: 35.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for viby-0.0.6.tar.gz
Algorithm Hash digest
SHA256 5f7db8d5c91374c134cb90ae34d59da3f1fb3c8cdd9c80dca48c0e9007d9c7b4
MD5 a483f84d50a4b2fe4d86273966e088e9
BLAKE2b-256 7ae918cd63cb662102e3e929c04b79067f3cb76313d25cbf903cbcab54dfafe9

See more details on using hashes here.

File details

Details for the file viby-0.0.6-py3-none-any.whl.

File metadata

  • Download URL: viby-0.0.6-py3-none-any.whl
  • Upload date:
  • Size: 42.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for viby-0.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 1af80e089c69ec229e392f759871822d6122dbcb10f38e37cea1b46ba73aaae8
MD5 98f0e44211a441c9b154abbb24118361
BLAKE2b-256 e41b75ae679461ddff83aca9d4b55bef8b7defd3cc750e69d0edabee297aa20f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page