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

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 --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 providers
  • janito --list-models - List all available models
  • janito --list-tools - List available tools
  • janito --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

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

🚀 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

janito-3.5.1.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.5.1-py3-none-any.whl (486.5 kB view details)

Uploaded Python 3

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

Hashes for janito-3.5.1.tar.gz
Algorithm Hash digest
SHA256 530b0d1d348c333dc569699969ab05d8c8c9b21867bd4c4933e35ed4e05a3808
MD5 23921995f4dad8cd84e6be27fa7cd1db
BLAKE2b-256 47f73a479add9179ea4cb7db9e643dccdf08ce08f737fef312a79f99bce6fe01

See more details on using hashes here.

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

Hashes for janito-3.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b1a1c03f0e85202fc82fef02964af2abba34c5e16f7d1c0a4b8bd8f07ceb5599
MD5 a12770bbeab511676b805812c62e4e09
BLAKE2b-256 11fe6905d1a8f9e4cdfac4215a1ea5525030a34639b254842ab49656e5911d19

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