janito - a development agent with function calling, MCP and skills
📖 Full documentation available at https://ikignosis.github.io/janito/
⚠️ Disclaimer: The code on this repo has been developed mostly using AI, more specifically the Qwen models.
Features
- 🔧 Function Calling - Built-in tools for file operations, web search, and more
- 📧 Gmail Integration - Read, search, and manage emails
- ☁️ OneDrive Integration - Browse, upload, download, and share files
- 🔌 MCP Support - Connect to Model Context Protocol servers
- 🧩 Skills - Install and use task-specific skills from GitHub
- 🌐 Web UI (Alpha) - Chat through a browser instead of the terminal with
--web - 📊 Real-time Progress - Watch tool execution progress as it happens
- 🚀 Easy Setup - Interactive configuration with
--configor quick setup with--setflags - 🔗 Any OpenAI-Compatible API - Works with OpenAI, local servers (LM Studio, Ollama), and custom endpoints
NOTE: Janito should be used on development systems on which data loss is tolerable and there are no critical secrets
Quick Start
# Install
pip install janito
# Or, with uv (recommended)
uv tool install janito
# Configure interactively
janito --config
# Or set options directly (two steps: config, then API key)
janito --set provider=openai --set model=gpt-4
janito --set-api-key="sk-your-key" --provider openai
# Start chatting
janito "Hello!"
Installation
From PyPI
pip install janito
Or, with uv:
uv tool install janito
For development setup, see README_DEV.md.
Configuration
Interactive Setup
janito --config
You'll be prompted for:
- Provider -
openaiorcustom - API Key - Masked for security
- Model - e.g.,
gpt-4,gpt-3.5-turbo - Max Output Tokens - Maximum output tokens (default: 65536)
Quick Configuration with --set
Set options directly from the command line:
# Single key-value
janito --set model=gpt-4
You can also use --get, --unset, and --set-secret with multiple values.
View Configuration
janito --show-config
Costs per provider
| Provider | Last Model | Price |
|---|---|---|
| Alibaba | qwen3.8-max | 6$/month (Lite) |
| Moonshot | kimi-k3 | $15/month (Moderato) |
| z.ai | glm-5.2 | $12.6/month (Lite) |
| openai | gpt-5.6 | Pay as you go |
For custom endpoints (base-url), see README_custom.md.
Usage
Single Prompt
janito "What is the capital of France?"
Pipe Input
echo "Tell me a joke" | janito
Interactive Chat
janito
Commands in chat mode:
exit/quit- End sessionrestart- Clear conversation historyCtrl+D/Ctrl+Z- Exit
Web UI (Alpha)
⚠️ Alpha — The
--webmode is currently in alpha. It works, but the interface, CLI flags, and API may change between releases.
Janito can serve a browser-based chat interface instead of the terminal. This requires optional dependencies that are not part of the core install:
# Install with the web extra
pip install janito[web]
# or
uv tool install janito[web]
Then start the server (opens your browser automatically):
janito --web
# All normal Janito flags still apply, plus web-specific ones:
janito --web -r -w --gmail --web-port 9090 # privileges + gmail, custom port
janito --web --no-web-open # don't auto-open the browser
The server binds to 127.0.0.1 by default (localhost only). For full details
(features, security, API endpoints, architecture), see the
Web UI documentation.
System Prompt Options
Control how the system prompt is handled:
# Use default system prompt (with tools enabled)
janito "What can you do?"
# Disable system prompt entirely (no tools)
janito -Z "Simple prompt without system context"
# Override with a custom system prompt (no tools)
janito -S "You are a concise coding assistant" "Explain recursion"
| Flag | Description |
|---|---|
-Z, --no-system-prompt |
Skip system prompt and disable tools |
-S, --system-prompt |
Custom system prompt (also disables tools) |
Note: When using
-Sor-Z, built-in tools (file operations, Gmail, OneDrive, MCP) are disabled. Use the default mode or--gmail/--onedriveflags when you need tool access.
Logging
janito --log=info "Your prompt" # Info level
janito --log=debug "Your prompt" # Debug level
janito --log=info,debug "Your prompt" # Multiple levels
Examples
OpenAI
# Step 1: Set provider and model
janito --set provider=openai --set model=gpt-4
# Step 2: Store API key
janito --set-api-key="sk-your-key" --provider openai
# Then run any prompt
janito "Explain quantum computing"
Alibaba (Qwen)
# Step 1: Set provider and model
janito --set provider=alibaba --set model=qwen-plus
# Step 2: Store API key
janito --set-api-key="your-dashscope-api-key" --provider alibaba
# Then run any prompt
janito "Explain quantum computing"
Custom Endpoint
janito --set provider=custom --set base-url=http://localhost:8000/v1
Built-in Tools
janito includes tools for common tasks:
Email Integration (Gmail)
# Use Gmail in chat mode
janito --gmail
# Check emails
janito --gmail "Show my unread emails from today"
For full Gmail documentation, see README.gmail.md.
Cloud Storage (OneDrive)
# Authenticate with Microsoft OneDrive
janito --onedrive-auth
# Use OneDrive in chat mode
janito --onedrive
# List files
janito --onedrive "List my files in Documents"
For full OneDrive documentation, see README.onedrive.md.
File Operations
# List files
python -m janito.tools.files.list_files . --recursive --pattern "*.py"
# Read file
python -m janito.tools.files.read_file README.md --max-lines 20
MCP Tools
Connect to MCP servers using the /mcp command inside the interactive shell:
# Add a stdio-based MCP server
/mcp add myserver stdio python -m mcp.server
# Add an HTTP-based MCP server
/mcp add remote http https://api.example.com/mcp
# List configured servers
/mcp list
For full MCP documentation, see README_MCP.md.
Tool Progress Reporting
Tools report progress in real-time:
🔄 Reading files...
📊 Processing: 50/100 files
✅ Completed: 100 files (2.3MB)
Progress messages go to stderr so they don't interfere with tool output.
Error Handling
| Exit Code | Meaning |
|---|---|
0 |
Success |
1 |
Configuration or runtime error |
130 |
User cancelled (Ctrl+C or Enter) |
Dependencies
- Python 3.10+
openai>=1.0.0rich>=10.0.0prompt-toolkit>=3.0.0requests>=2.28.0(for MCP support)pathspec>=0.11.0(for.gitignore-aware file listing)
License
MIT License
2 maintainers
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-4.20.0.tar.gz.
File metadata
- Download URL: janito-4.20.0.tar.gz
- Upload date:
- Size: 680.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e2050e238512b3fc3535b3d247091e67ce51f3b5610bd8091ad89a3d4008c100
|
|
| MD5 |
94962c54c5c4a30c9aa1b7e12fc70aaa
|
|
| BLAKE2b-256 |
db6cf0809710648782c21be78e9fa7325c5c9bb1c99dcd570a693c274afc8724
|
Provenance
The following attestation bundles were made for janito-4.20.0.tar.gz:
Publisher:
release.yaml on ikignosis/janito
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
janito-4.20.0.tar.gz -
Subject digest:
e2050e238512b3fc3535b3d247091e67ce51f3b5610bd8091ad89a3d4008c100 - Sigstore transparency entry: 2371502010
- Sigstore integration time:
-
Permalink:
ikignosis/janito@3e47b7663f458d56a15b66fa767c4a23be768a0c -
Branch / Tag:
refs/tags/v4.20.0 - Owner: https://github.com/ikignosis
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yaml@3e47b7663f458d56a15b66fa767c4a23be768a0c -
Trigger Event:
push
-
Statement type:
File details
Details for the file janito-4.20.0-py3-none-any.whl.
File metadata
- Download URL: janito-4.20.0-py3-none-any.whl
- Upload date:
- Size: 393.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bd4ff8d66f39d5e6ccaf6bd8b9e88953c78f98e58f5ac268f58b09ce556693e3
|
|
| MD5 |
20da8dc1a7513b4c3e0d3fbba72fa93d
|
|
| BLAKE2b-256 |
d6eff711882bebf8903504aaf8ac4e21467d8bb586e148d5d1b3aef79bb8c868
|
Provenance
The following attestation bundles were made for janito-4.20.0-py3-none-any.whl:
Publisher:
release.yaml on ikignosis/janito
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
janito-4.20.0-py3-none-any.whl -
Subject digest:
bd4ff8d66f39d5e6ccaf6bd8b9e88953c78f98e58f5ac268f58b09ce556693e3 - Sigstore transparency entry: 2371502038
- Sigstore integration time:
-
Permalink:
ikignosis/janito@3e47b7663f458d56a15b66fa767c4a23be768a0c -
Branch / Tag:
refs/tags/v4.20.0 - Owner: https://github.com/ikignosis
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yaml@3e47b7663f458d56a15b66fa767c4a23be768a0c -
Trigger Event:
push
-
Statement type:
