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-k2-0905 "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-k2-0905

Providers

Moonshot (Recommended)

  • Models: kimi-k2-0905, kimi-k2-turbo-preview, kimi-k2-0711-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-k2-0905

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

This version

3.6.1

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.6.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.6.1-py3-none-any.whl (484.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: janito-3.6.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.6.1.tar.gz
Algorithm Hash digest
SHA256 e89a0a5f975c849308e1f2ce36ebb8c7cede0bf5d51ce61d75539cdfd3f541c5
MD5 10488ef336c5db0af478fca2ebbbfcd7
BLAKE2b-256 85ca3ba8ee882cda6717927d0a11841386ccc6246f18cf841ecaac2f54c1e91a

See more details on using hashes here.

File details

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

File metadata

  • Download URL: janito-3.6.1-py3-none-any.whl
  • Upload date:
  • Size: 484.9 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.6.1-py3-none-any.whl
Algorithm Hash digest
SHA256 49f6a4af40f49c0a78888a274b675bbf64432dd92c47f2456adf9f62ff034cb7
MD5 b103b0b23cd41b810437846b5636a879
BLAKE2b-256 e14a59e8bdec8b72852477992100c4cf8d8dd2481f6c4606c6446765fea1653c

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