A new Python package called janito.
Project description
Janito CLI
A powerful command-line tool for running LLM-powered workflows with built-in tool execution capabilities.
Quick Start
Installation
pip install janito
First-Time Setup
- Get your API key: Sign up at Moonshot AI and get your API key
- Set your API key:
janito --set-api-key YOUR_MOONSHOT_API_KEY -p moonshot
Basic Usage
Moonshot (Recommended - Default Provider)
# Using the default provider (moonshot) and model
janito "Create a Python script that reads a CSV file"
# Using a specific Moonshot model
janito -m kimi-k1-8k "Explain quantum computing"
Other Providers
# OpenAI
janito -p openai -m gpt-4 "Write a React component"
# Anthropic
janito -p anthropic -m claude-3-5-sonnet-20241022 "Analyze this code"
# Google
janito -p google -m gemini-2.0-flash-exp "Generate unit tests"
Interactive Chat Mode
Start an interactive session (default mode):
janito
Or explicitly:
janito --chat
In chat mode, you can:
- Have multi-turn conversations
- Execute code and commands
- Read and write files
- Use built-in tools
Available Commands
janito --list-providers- List all supported providersjanito --list-models- List all available modelsjanito --list-tools- List available toolsjanito --show-config- Show current configuration
Configuration
Set default provider and model:
janito --set provider=moonshot
janito --set model=kimi-k1-8k
Providers
Moonshot (Recommended)
- Models: kimi-k1-8k, kimi-k1-32k, kimi-k1-128k, kimi-k2-turbo-preview
- Strengths: Excellent Chinese/English support, competitive pricing, fast responses
- Setup: Get API key from Moonshot AI Platform
OpenAI
- Models: gpt-5, gpt-4.1, gpt-4o, gpt-4-turbo, gpt-3.5-turbo
- Setup: Get API key from OpenAI Platform
Anthropic
- Models: claude-3-7-sonnet-20250219, claude-3-5-sonnet-20241022, claude-3-opus-20250514
- Setup: Get API key from Anthropic Console
IBM WatsonX
- Models: ibm/granite-3-8b-instruct, ibm/granite-3-2b-instruct, meta-llama/llama-3-1-8b-instruct, meta-llama/llama-3-1-70b-instruct, mistralai/mistral-large
- Strengths: Enterprise-grade AI, IBM Granite models, hosted Llama and Mistral models
- Setup: Get API key and project ID from IBM Cloud
- Models: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-lite-preview-06-17
- Setup: Get API key from Google AI Studio
Advanced Features
🚀 New in v3.1.0: Enter Key Cancellation
Chat Mode Enhancement: Press Enter at any time to instantly cancel long-running requests in interactive chat mode. No more waiting for stuck requests!
Tool Usage
Janito includes powerful built-in tools for:
- File operations (read, write, search)
- Code execution
- Web scraping
- System commands
- And more...
Profiles
Use predefined system prompts:
janito --developer "Create a REST API" # Same as --profile developer
janito --market "Analyze market trends" # Same as --profile market-analyst
Environment Variables
You can also configure via environment variables:
Moonshot:
export MOONSHOT_API_KEY=your_key_here
export JANITO_PROVIDER=moonshot
export JANITO_MODEL=kimi-k1-8k
OpenAI:
export OPENAI_API_KEY=your_key_here
export JANITO_PROVIDER=openai
export JANITO_MODEL=gpt-5
IBM WatsonX:
export WATSONX_API_KEY=your_key_here
export WATSONX_PROJECT_ID=your_project_id
export WATSONX_SPACE_ID=your_space_id # optional
export JANITO_PROVIDER=ibm
export JANITO_MODEL=ibm/granite-3-8b-instruct
Anthropic:
export ANTHROPIC_API_KEY=your_key_here
export JANITO_PROVIDER=anthropic
export JANITO_MODEL=claude-3-7-sonnet-20250219
Google:
export GOOGLE_API_KEY=your_key_here
export JANITO_PROVIDER=google
export JANITO_MODEL=gemini-2.5-flash
Examples
Code Generation
janito "Create a Python FastAPI application with user authentication"
File Analysis
janito "Analyze the performance bottlenecks in my_app.py"
Data Processing
janito "Process this CSV file and generate summary statistics"
Web Development
janito "Create a responsive landing page with Tailwind CSS"
Support
- Documentation: Check individual provider directories for detailed setup guides
- Issues: Report bugs and feature requests on GitHub
- Discord: Join our community for help and discussions
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file janito-3.5.1.tar.gz.
File metadata
- Download URL: janito-3.5.1.tar.gz
- Upload date:
- Size: 1.7 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
530b0d1d348c333dc569699969ab05d8c8c9b21867bd4c4933e35ed4e05a3808
|
|
| MD5 |
23921995f4dad8cd84e6be27fa7cd1db
|
|
| BLAKE2b-256 |
47f73a479add9179ea4cb7db9e643dccdf08ce08f737fef312a79f99bce6fe01
|
File details
Details for the file janito-3.5.1-py3-none-any.whl.
File metadata
- Download URL: janito-3.5.1-py3-none-any.whl
- Upload date:
- Size: 486.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b1a1c03f0e85202fc82fef02964af2abba34c5e16f7d1c0a4b8bd8f07ceb5599
|
|
| MD5 |
a12770bbeab511676b805812c62e4e09
|
|
| BLAKE2b-256 |
11fe6905d1a8f9e4cdfac4215a1ea5525030a34639b254842ab49656e5911d19
|