Skip to main content

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

  1. Get your API key: Sign up at Moonshot AI and get your API key
  2. 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 providers
  • janito --list-models - List all available models
  • janito --list-tools - List all available tools
  • janito --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

Google

  • 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 PROVIDER and 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

janito-3.21.0.tar.gz (1.7 MB view details)

Uploaded Source

Built Distribution

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

janito-3.21.0-py3-none-any.whl (369.0 kB view details)

Uploaded Python 3

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

Hashes for janito-3.21.0.tar.gz
Algorithm Hash digest
SHA256 ac2f9e3c23ea6737d3de52f312b43dee3d7027ac5f874e9ca3bda7df773f131c
MD5 21792f68effae61819e2be702cddb0a4
BLAKE2b-256 481a6d725cb2b3503ce21d9ff61a40dda000ac5ad507c3a65c6e6059afac11a7

See more details on using hashes here.

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

Hashes for janito-3.21.0-py3-none-any.whl
Algorithm Hash digest
SHA256 476f688ecf828671b7c461e78f8097b243396d4fe28286dfa0f20e322c1cc0d6
MD5 db74b50e7522ef3adba8b5ef9a5ded7f
BLAKE2b-256 da08b45150411d38885f518d66f7a227ec2216d6fc22aaee45aa2d14f2663696

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