Skip to main content

Viby vibes everything

Project description

Viby Logo

Viby

Viby vibes everything

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

English | 中文

✨ Features

  • Intelligent Conversations - Engage in natural multi-turn dialogues
  • Command Generation - Get optimized shell commands
  • 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.

⭐ Star History

📄 Documentation

For more details on the project's design and architecture, please refer to the Viby Project Design Document.

🤝 Contributing

Contributions are welcome! Feel free to submit a Pull Request or create an Issue.

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.9.tar.gz (42.1 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.9-py3-none-any.whl (48.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: viby-0.0.9.tar.gz
  • Upload date:
  • Size: 42.1 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.9.tar.gz
Algorithm Hash digest
SHA256 e4fcdb335a9f81d5b3cb48d92e7cff48a8ceb2f9aa5010afc2e1b04659e5e614
MD5 e0b877e200b24b859a9248268147b109
BLAKE2b-256 d778445ae5cd686552c59a41207a0693608be1ad0810fd841fd052a7f0f0c27e

See more details on using hashes here.

File details

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

File metadata

  • Download URL: viby-0.0.9-py3-none-any.whl
  • Upload date:
  • Size: 48.7 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.9-py3-none-any.whl
Algorithm Hash digest
SHA256 107bf7f20020ef62f4558f68519b548832dffccaf589e5f138a83adec82b73f0
MD5 d5205ba7062f66612d7cc508fb5a03a0
BLAKE2b-256 5a179fc8825218471c5940ff4b87461af5a799be8a4ea60f0baf403a608a4c83

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