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
uv 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 -p moonshot --set-api-key YOUR_MOONSHOT_API_KEY
Basic Usage
Moonshot (Recommended - Default Provider)
# Using the default provider
janito "Create a Python script that reads a CSV file"
# Using a specific Moonshot model
janito -m kimi-k2-thinking "Explain quantum computing"
Other Providers
# OpenAI
janito -p openai -m gpt-4 "Write a React component"
# Anthropic
janito -p anthropic -m claude-sonnet-4-5-20250929 "Analyze this code"
# Google
janito -p google -m gemini-2.0-flash-exp "Generate unit tests"
Interactive Chat Mode
By default, running janito without any arguments starts an interactive chat session:
janito
In chat mode, you can:
-
Have multi-turn conversations
-
Execute code and commands
-
One-shot mode: Pass a prompt directly for single tasks:
janito "Create a Python script that reads a CSV file"
Available Commands
janito --list-providers- List all supported providersjanito --list-models- List all available modelsjanito --list-tools- List all available toolsjanito --show-config- Show current configuration
Configuration
Set default provider and model:
janito --set provider=moonshot
janito --set model=kimi-k2-thinking
Providers
Moonshot (Recommended)
- Models: kimi-k2-turbo-preview, kimi-k2-thinking, kimi-k2-0905-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
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
Note: API keys are set via
janito --set-api-key YOUR_KEY -p PROVIDERand stored in~/.janito/auth.json. Provider-specific API key environment variables are not supported.
The following environment variables are supported:
| Variable | Description |
|---|---|
BASE_URL |
Custom API base URL (overrides provider default) |
BASE_API_KEY |
Custom API key (overrides provider-specific API key) |
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
- Full Documentation: https://ikignosis.org/janito/
- 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.21.0.tar.gz.
File metadata
- Download URL: janito-3.21.0.tar.gz
- Upload date:
- Size: 1.7 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.18
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ac2f9e3c23ea6737d3de52f312b43dee3d7027ac5f874e9ca3bda7df773f131c
|
|
| MD5 |
21792f68effae61819e2be702cddb0a4
|
|
| BLAKE2b-256 |
481a6d725cb2b3503ce21d9ff61a40dda000ac5ad507c3a65c6e6059afac11a7
|
File details
Details for the file janito-3.21.0-py3-none-any.whl.
File metadata
- Download URL: janito-3.21.0-py3-none-any.whl
- Upload date:
- Size: 369.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.18
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
476f688ecf828671b7c461e78f8097b243396d4fe28286dfa0f20e322c1cc0d6
|
|
| MD5 |
db74b50e7522ef3adba8b5ef9a5ded7f
|
|
| BLAKE2b-256 |
da08b45150411d38885f518d66f7a227ec2216d6fc22aaee45aa2d14f2663696
|