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.0.2.tar.gz (368.4 kB 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.0.2-py3-none-any.whl (469.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: sahya_code-1.0.2.tar.gz
  • Upload date:
  • Size: 368.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.4

File hashes

Hashes for sahya_code-1.0.2.tar.gz
Algorithm Hash digest
SHA256 18b22be006bb8f36bbc4ef6e0d0e8a8f6dafffcbb62bad6980a39438a285cda0
MD5 a0824321f9fdb98f6831be19daabac8a
BLAKE2b-256 7ba8f2ffe46387e85e2561f0366a130d6ad647ff56a49efaa9a8a87e83d102b4

See more details on using hashes here.

File details

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

File metadata

  • Download URL: sahya_code-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 469.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.4

File hashes

Hashes for sahya_code-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 53d658e25e70fa3ed73064f416c36925465e524e0efaa7e081a90c2b746a8a7b
MD5 887c7df57672e636072af418bec0f6ab
BLAKE2b-256 ea547d076fdfeb3ac9058bf520646f917ec35e5f086fc8f52673060d5d8c4917

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