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.22.0.tar.gz (1.6 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.22.0-py3-none-any.whl (266.2 kB view details)

Uploaded Python 3

File details

Details for the file janito-3.22.0.tar.gz.

File metadata

  • Download URL: janito-3.22.0.tar.gz
  • Upload date:
  • Size: 1.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.18

File hashes

Hashes for janito-3.22.0.tar.gz
Algorithm Hash digest
SHA256 6f2917cda91cfd5d4790260a8e8e173219c014954f0ad4e62d22c2142458c7ef
MD5 16ab1de6d9cb77e3397c22ec5e1534bf
BLAKE2b-256 666d2ff4448d72a317c245d6377b2520ac4872d59ca666e79ab9a3128e217429

See more details on using hashes here.

File details

Details for the file janito-3.22.0-py3-none-any.whl.

File metadata

  • Download URL: janito-3.22.0-py3-none-any.whl
  • Upload date:
  • Size: 266.2 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.22.0-py3-none-any.whl
Algorithm Hash digest
SHA256 818b95264eea17ff2b3dc4b51adecc4b0cbd9e508148ab6148998b40d195f0ee
MD5 030a23d38b33a108bfdbb1cb436d8abe
BLAKE2b-256 453672bda020d05b3186f952f8ffcc4fd3163b88b9789e6a2b40ef1945b1020b

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