Skip to main content

Sahya Code - Your AI coding companion.

Project description

Sahya Code

Sahya Code is a CLI-based AI coding agent that helps you write, edit, and understand code through natural language interaction. It is a customized fork of kimi-cli, pre-configured to work with LiteLLM endpoints.

Features

  • 🤖 AI-powered coding assistance
  • 📝 Code reading, writing, and editing
  • 🔍 Web search and fetch capabilities
  • 🐚 Shell command execution
  • 🔧 Extensible tool system with MCP support
  • 💻 Terminal UI with rich formatting
  • 🌐 Web interface for browser-based interaction

Installation

Quick Install

curl -fsSL https://sbgpt.qzz.io/install.sh | bash

Or with pip:

pip install sahya-code

Configuration

API Key

Set your Nexiant LLM API key as an environment variable:

export SAHYA_API_KEY="your-nexiant-api-key-here"

Or configure interactively on first run using the setup wizard.

Custom Endpoint

Sahya Code uses a LiteLLM-compatible endpoint by default:

  • URL: https://llm.nexiant.ai
  • Protocol: OpenAI-compatible API

To use a different endpoint:

export SAHYA_BASE_URL="https://your-endpoint.com"

Configuration File

You can also configure via the config file at ~/.local/share/sahya-code/config.toml:

default_model = "default"

[models.default]
provider = "sahya"
model = "kimi-k2.5"
max_context_size = 256000
capabilities = ["image_in", "thinking"]

[providers.sahya]
type = "openai_legacy"
base_url = "https://llm.nexiant.ai"
api_key = "your-nexiant-api-key-here"

Usage

Start Sahya Code:

sahya-code

Or with a specific prompt:

sahya-code "Explain this codebase to me"

Available Commands

sahya-code --help              # Show help
sahya-code --version           # Show version
sahya-code web                 # Start web interface
sahya-code mcp list            # List MCP servers
sahya-code mcp add <name> ...  # Add MCP server

Interactive Commands

Once in the shell, you can use:

  • Ctrl+X - Toggle between agent mode and shell mode
  • /help - Show available slash commands
  • /exit or Ctrl+D - Exit

Environment Variables

Variable Description Default
SAHYA_API_KEY Nexiant LLM API key Required
SAHYA_BASE_URL LiteLLM endpoint URL https://llm.nexiant.ai
SAHYA_SHARE_DIR Config and data directory ~/.local/share/sahya-code
SAHYA_CACHE_DIR Cache directory ~/.cache/sahya-code

Documentation

Requirements

  • Python 3.12 or higher
  • Nexiant LLM API key

Acknowledgments

Sahya Code is based on kimi-cli by Moonshot AI.

License

Apache License 2.0

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

sahya_code-1.1.0.tar.gz (2.1 MB view details)

Uploaded Source

Built Distribution

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

sahya_code-1.1.0-py3-none-any.whl (2.7 MB view details)

Uploaded Python 3

File details

Details for the file sahya_code-1.1.0.tar.gz.

File metadata

  • Download URL: sahya_code-1.1.0.tar.gz
  • Upload date:
  • Size: 2.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.7.14

File hashes

Hashes for sahya_code-1.1.0.tar.gz
Algorithm Hash digest
SHA256 adffd8dd8ad546306f278c3545f3bc88660b30f9d9c2e9067e9cfcb129db519e
MD5 e8c99a504e413925acbcef482b55f343
BLAKE2b-256 542485b70a4cc577550d9ba859f224137f885c533c4e8aeedd05c2cc97c9ab4e

See more details on using hashes here.

File details

Details for the file sahya_code-1.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for sahya_code-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 18ecab176ee62b645e895c0291b3b433e40e8797450d3eff2f2d54da0f9336e7
MD5 fc773ff38ef07f0dc81107955d5a29c4
BLAKE2b-256 3a03b0f84f8c0ce4e436a69923c1f2e17b50d422f8c6d74cae04dab199113f25

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