janito 2.15.0__tar.gz → 2.17.0__tar.gz

{janito-2.15.0 → janito-2.17.0}/CHANGELOG.md

@@ -2,31 +2,144 @@
 
 All notable changes to this project will be documented in this file.
 
-## [2.12.0] - 2025-08-05
+## [Unreleased]
+
+## [2.17.0] - 2025-08-05
 
 ### Added
-- **Enhanced Provider Documentation**: Updated supported-providers-models.md with comprehensive provider information including drivers and dependencies
-- **Improved Driver Listing**: Enhanced list_drivers command with better dependency detection and duplicate removal
-- **Z.AI Provider**: Added ZAIModelDriver with OpenAI SDK compatibility for Z.AI API
-- **Google Gemini Provider**: Added support for Gemini Pro and Gemini 1.5 Pro models via OpenAI-compatible API
-- **DeepSeek Provider**: Added support for deepseek-chat and deepseek-coder models via OpenAI-compatible API
-- **Alibaba Provider**: Added support for qwen-turbo, qwen-plus, qwen-max, and qwen3-coder-plus models via OpenAI-compatible API
-- **MoonshotAI Provider**: Enhanced with additional models and OpenAI-compatible API support
-- **Azure OpenAI Provider**: Added support for GPT-4o and GPT-4o-mini models
+
+- **New Provider Support**
+  - **Cerebras Provider**: Added complete support for Cerebras with qwen-3-coder-480b model
+    - qwen-3-coder-480b: 32k context, reasoning-focused model with function calling support
+
+- **Enhanced UX**
+  - Improved error handling for invalid provider names in set-api-key command
+  - Better error messages when provider is not found
 
 ### Changed
-- **CLI Core**: Updated getter functions to exit after execution for better CLI behavior
-- **Driver Architecture**: Enhanced ZAI driver to use OpenAI SDK instead of Z.AI SDK for better compatibility
-- **Dependency Management**: Improved dependency detection in list_drivers command with duplicate removal
-- **Provider Registry**: Enhanced provider information display with driver names and dependency status
-- **Model Support**: Updated all providers to use OpenAI-compatible API where applicable, expanding model availability
+
+- **Provider Improvements**
+  - Updated Alibaba endpoint to international URL for better global access
+  - Simplified region display to 2-letter codes for cleaner output
+  - Improved driver listing and region display functionality
+
+- **Zero Mode Enhancement**
+  - Zero mode now properly disables system prompt and tools for minimal interaction
 
 ### Fixed
-- **Driver Configuration**: Fixed AttributeError in ZAI provider by initializing _driver_config properly
-- **Import Handling**: Added proper import error handling for optional dependencies in ZAI driver
-- **CLI Integration**: Fixed list_drivers integration into main CLI flow
 
-## [2.11.0] - 2025-08-04
+- **Bug Fixes**
+  - Added missing tools adapter to Cerebras provider
+  - Improved error handling for invalid provider names in set-api-key command
+
+## [2.16.0] - 2025-01-08
+
+### Added
+
+- **New CLI Features**
+  - `--python` flag: Start directly with Python developer profile without manual selection
+  - `--multi` option: Enable default multiline input in chat mode
+  - `--list-drivers` command: List available LLM drivers and their dependencies
+  - `--list-providers-region` command: Show providers with region information
+
+- **New Providers**
+  - **Z.AI Provider**: Complete support for Z.AI with GLM-4.5, GLM-4, and GLM-4V models
+    - GLM-4.5: 128k context with thinking support for advanced reasoning
+    - GLM-4: General-purpose model with 128k context
+    - GLM-4V: Vision model for image understanding with 128k context
+  - **Alibaba Cloud Provider**: Support for Qwen models including qwen-turbo, qwen-plus, qwen-max, and qwen3-coder-plus
+
+- **Enhanced UX**
+  - Model information display now includes backend hostname in both chat and single-shot modes
+  - Improved region management with geolocation utilities
+  - Enhanced error handling for missing API keys and dependencies
+
+### Changed
+
+- **Provider Improvements**
+  - Updated Z.AI provider to use official SDK with improved model support
+  - Changed default GLM model from air to regular version
+  - Updated Alibaba endpoint to international URL for better global access
+  - Simplified region display to 2-letter codes for cleaner output
+
+- **Documentation**
+  - Updated documentation URLs to use GitHub Pages default domain
+  - Fixed documentation URL to docs.janito.dev
+  - Enhanced provider documentation with new Z.AI and Alibaba Cloud details
+
+### Fixed
+
+- **Bug Fixes**
+  - Fixed AttributeError when ZAIProvider API key is missing
+  - Removed accidentally committed test files
+  - Improved error handling and user experience in profile selection
+  - Fixed various import order issues for better code organization
+
+- **Code Quality**
+  - Refactored provider registry for reduced complexity
+  - Improved CLI argument handling and validation
+  - Enhanced terminal output styling and formatting
+
+### Security
+
+- **Enhanced Security**
+  - Improved privilege checking and status display in chat sessions
+  - Enhanced error handling for missing dependencies and API keys
+  - Better validation of provider configurations
+
+### Technical Improvements
+
+- **Architecture**
+  - Refactored core CLI and runner modules for better maintainability
+  - Improved prompt handling and streamlined main CLI logic
+  - Enhanced provider registry with new visual indicators
+  - Better separation of concerns in driver and provider implementations
+
+- **Performance**
+  - Optimized model information retrieval
+  - Improved startup performance with better configuration handling
+  - Enhanced memory usage in chat sessions
+
+### Developer Experience
+
+- **Testing**
+  - Added comprehensive tests for new CLI commands
+  - Improved test coverage for provider configurations
+  - Enhanced error handling in test scenarios
+
+- **Documentation**
+  - Updated all provider documentation with new features
+  - Added comprehensive setup guides for new providers
+  - Improved CLI usage examples and syntax highlighting
+
+## [2.15.0] - 2025-08-05
+
+## [2.16.0] - 2025-01-08
+
+### Added
+
+- Added `--python` CLI flag to start with the Python developer profile without manual profile selection
+- Added `--list-drivers` CLI command to list available LLM drivers and their dependencies
+- Added `--multi` CLI option for default multiline input in chat mode
+- Enhanced model information display with backend hostname in both chat and single-shot modes
+
+### Changed
+
+- Updated Z.AI provider to use official SDK with improved model support
+- Changed default GLM model from air to regular version
+- Updated documentation URLs to use GitHub Pages default domain
+
+### Fixed
+
+- Fixed AttributeError when ZAIProvider API key is missing
+- Removed accidentally committed test files
+- Improved error handling and user experience in profile selection
+
+### Security
+
+- Enhanced privilege checking and status display in chat sessions
+
+## [2.15.0] - 2025-08-05
 
 ### Added
 

janito-2.17.0/CHANGELOG_2.16.0.md

@@ -0,0 +1,81 @@
+# Changelog v2.16.0
+
+## [2.16.0] - 2025-01-08
+
+### Added
+
+- **New CLI Features**
+  - `--python` flag: Start directly with Python developer profile without manual selection
+  - `--multi` option: Enable default multiline input in chat mode
+  - `--list-drivers` command: List available LLM drivers and their dependencies
+  - `--list-providers-region` command: Show providers with region information
+
+- **New Providers**
+  - **Z.AI Provider**: Complete support for Z.AI with GLM-4.5, GLM-4, and GLM-4V models
+    - GLM-4.5: 128k context with thinking support for advanced reasoning
+    - GLM-4: General-purpose model with 128k context
+    - GLM-4V: Vision model for image understanding with 128k context
+  - **Alibaba Cloud Provider**: Support for Qwen models including qwen-turbo, qwen-plus, qwen-max, and qwen3-coder-plus
+
+- **Enhanced UX**
+  - Model information display now includes backend hostname in both chat and single-shot modes
+  - Improved region management with geolocation utilities
+  - Enhanced error handling for missing API keys and dependencies
+
+### Changed
+
+- **Provider Improvements**
+  - Updated Z.AI provider to use official SDK with improved model support
+  - Changed default GLM model from air to regular version
+  - Updated Alibaba endpoint to international URL for better global access
+  - Simplified region display to 2-letter codes for cleaner output
+
+- **Documentation**
+  - Updated documentation URLs to use GitHub Pages default domain
+  - Fixed documentation URL to docs.janito.dev
+  - Enhanced provider documentation with new Z.AI and Alibaba Cloud details
+
+### Fixed
+
+- **Bug Fixes**
+  - Fixed AttributeError when ZAIProvider API key is missing
+  - Removed accidentally committed test files
+  - Improved error handling and user experience in profile selection
+  - Fixed various import order issues for better code organization
+
+- **Code Quality**
+  - Refactored provider registry for reduced complexity
+  - Improved CLI argument handling and validation
+  - Enhanced terminal output styling and formatting
+
+### Security
+
+- **Enhanced Security**
+  - Improved privilege checking and status display in chat sessions
+  - Enhanced error handling for missing dependencies and API keys
+  - Better validation of provider configurations
+
+### Technical Improvements
+
+- **Architecture**
+  - Refactored core CLI and runner modules for better maintainability
+  - Improved prompt handling and streamlined main CLI logic
+  - Enhanced provider registry with new visual indicators
+  - Better separation of concerns in driver and provider implementations
+
+- **Performance**
+  - Optimized model information retrieval
+  - Improved startup performance with better configuration handling
+  - Enhanced memory usage in chat sessions
+
+### Developer Experience
+
+- **Testing**
+  - Added comprehensive tests for new CLI commands
+  - Improved test coverage for provider configurations
+  - Enhanced error handling in test scenarios
+
+- **Documentation**
+  - Updated all provider documentation with new features
+  - Added comprehensive setup guides for new providers
+  - Improved CLI usage examples and syntax highlighting

{janito-2.15.0 → janito-2.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janito
-Version: 2.15.0
+Version: 2.17.0
 Summary: A new Python package called janito.
 Author-email: João Pinto <janito@ikignosis.org>
 Project-URL: Homepage, https://github.com/ikignosis/janito

janito-2.17.0/docs/cerebras-setup.md

@@ -0,0 +1,56 @@
+# Cerebras Setup Guide
+
+This guide will help you set up Janito to use Cerebras as an LLM provider.
+
+## Prerequisites
+
+1. A Cerebras account
+2. An API key from Cerebras
+
+## Getting an API Key
+
+1. Visit the [Cerebras API Keys page](https://api.cerebras.ai/)
+2. Log in to your account
+3. Generate a new API key
+4. Copy the API key for use in Janito
+
+## Configuration
+
+To configure Janito to use Cerebras, you need to set your API key:
+
+```bash
+janito --set-api-key YOUR_CEREBRAS_API_KEY -p cerebras
+```
+
+Replace `YOUR_CEREBRAS_API_KEY` with the API key you obtained from Cerebras.
+
+## Usage
+
+After setting up your API key, you can use Cerebras models with Janito:
+
+```bash
+janito -p cerebras "Hello, how are you?"
+```
+
+By default, Janito will use the `qwen-3-coder-480b` model. You can specify a different model if needed:
+
+```bash
+janito -p cerebras -m qwen-3-coder-480b "Explain quantum computing"
+```
+
+## Available Models
+
+Cerebras offers several models through their API:
+
+- `qwen-3-coder-480b`: 32k context, reasoning-focused model with function calling support
+
+## Troubleshooting
+
+If you encounter issues:
+
+1. Verify your API key is correct and active
+2. Check that you have internet connectivity
+3. Ensure you're using a supported model name
+4. Check the Cerebras status page for any service outages
+
+For further assistance, consult the [Cerebras documentation](https://api.cerebras.ai/docs) or [Janito documentation](https://docs.janito.dev).

janito-2.17.0/docs/supported-providers-models.md

@@ -0,0 +1,65 @@
+# Supported Providers and Models
+
+This page lists the supported providers and their available models.
+
+## OpenAI
+
+- GPT-3.5 Turbo
+- GPT-4
+- GPT-4 Turbo
+
+## Google
+
+- Gemini Pro
+- Gemini 1.5 Pro
+
+## Anthropic
+
+- Claude 2
+- Claude 3 Opus
+- Claude 3 Sonnet
+- Claude 3 Haiku
+
+## MoonshotAI
+
+- kimi-k2-turbo-preview
+- kimi-k2-turbo-preview
+- kimi-k1-8k
+- kimi-k1-32k
+- kimi-k1-128k
+
+- Llama-3-8b-8192
+- Llama-3-70b-8192
+
+## Alibaba
+
+- qwen-turbo
+- qwen-plus
+- qwen-max
+- qwen3-coder-plus (default)
+- qwen3-coder-480b-a35b-instruct
+
+## Z.AI
+
+- glm-4.5
+- glm-4.5-air
+
+## Cerebras
+
+**Production Models:**
+- llama-4-scout-17b-16e-instruct
+- llama-3.3-70b
+- llama3.1-8b
+- qwen-3-32b
+
+**Preview Models:**
+- llama-4-maverick-17b-128e-instruct
+- qwen-3-235b-a22b-instruct-2507
+- qwen-3-235b-a22b-thinking-2507
+- qwen-3-coder-480b
+- gpt-oss-120b
+
+**Notes:**
+- qwen-3-coder-480b: 32k context, reasoning-focused model with function calling support
+
+<!-- Removed links to model_info.py files for all providers to avoid broken references. -->

{janito-2.15.0 → janito-2.17.0}/janito/agent/setup_agent.py

@@ -167,7 +167,7 @@ def setup_agent(
     """
     Creates an agent. A system prompt is rendered from a template only when a profile is specified.
     """
-    if no_tools_mode:
+    if no_tools_mode or zero_mode:
         tools_provider = None
     else:
         tools_provider = get_local_tools_adapter()

{janito-2.15.0 → janito-2.17.0}/janito/cli/chat_mode/session.py

@@ -115,9 +115,15 @@ class ChatSession:
     def _select_profile_and_role(self, args, role):
         profile = getattr(args, "profile", None) if args is not None else None
         role_arg = getattr(args, "role", None) if args is not None else None
+        python_profile = getattr(args, "python", False) if args is not None else False
         profile_system_prompt = None
         no_tools_mode = False
-        if profile is None and role_arg is None:
+
+        # Handle --python flag
+        if python_profile and profile is None and role_arg is None:
+            profile = "Developer with Python Tools"
+
+        if profile is None and role_arg is None and not python_profile:
             try:
                 from janito.cli.chat_mode.session_profile_select import select_profile
 
@@ -277,6 +283,41 @@ class ChatSession:
                 else None
             )
             start_time = time.time()
+
+            # Print rule line with model info before processing prompt
+            model_name = (
+                self.agent.get_model_name()
+                if hasattr(self.agent, "get_model_name")
+                else "Unknown"
+            )
+            provider_name = (
+                self.agent.get_provider_name()
+                if hasattr(self.agent, "get_provider_name")
+                else "Unknown"
+            )
+
+            # Get backend hostname if available
+            backend_hostname = "Unknown"
+            if hasattr(self.agent, "driver") and self.agent.driver:
+                if hasattr(self.agent.driver, "config") and hasattr(
+                    self.agent.driver.config, "base_url"
+                ):
+                    base_url = self.agent.driver.config.base_url
+                    if base_url:
+                        try:
+                            from urllib.parse import urlparse
+
+                            parsed = urlparse(base_url)
+                            backend_hostname = parsed.netloc
+                        except Exception:
+                            backend_hostname = base_url
+
+            self.console.print(
+                Rule(
+                    f"[bold blue]Model: {model_name} ({provider_name}) | Backend: {backend_hostname}[/bold blue]"
+                )
+            )
+
             self._prompt_handler.run_prompt(cmd_input)
             end_time = time.time()
             elapsed = end_time - start_time

janito-2.17.0/janito/cli/cli_commands/list_drivers.py

@@ -0,0 +1,162 @@
+"""
+CLI Command: List available LLM drivers and their dependencies
+"""
+
+import importlib
+import sys
+from pathlib import Path
+from rich.console import Console
+from rich.table import Table
+from rich.panel import Panel
+from rich.text import Text
+
+console = Console()
+
+
+def _detect_dependencies_from_content(content, class_name):
+    """Detect dependencies from module content."""
+    dependencies = []
+
+    if "import openai" in content or "from openai" in content:
+        dependencies.append("openai")
+    if "import zai" in content or "from zai" in content:
+        dependencies.append("zai")
+    if "import anthropic" in content or "from anthropic" in content:
+        dependencies.append("anthropic")
+    if "import google" in content or "from google" in content:
+        dependencies.append("google-generativeai")
+
+    # Remove openai from zai driver dependencies
+    if "ZAIModelDriver" in class_name and "openai" in dependencies:
+        dependencies.remove("openai")
+
+    return dependencies
+
+
+def _check_dependency_status(dependencies):
+    """Check if dependencies are available."""
+    if not dependencies:
+        return ["No external dependencies"]
+
+    dep_status = []
+    for dep in dependencies:
+        try:
+            importlib.import_module(dep)
+            dep_status.append(f"✅ {dep}")
+        except ImportError:
+            dep_status.append(f"❌ {dep}")
+
+    return dep_status
+
+
+def _get_single_driver_info(module_path, class_name):
+    """Get information for a single driver."""
+    try:
+        module = importlib.import_module(module_path)
+        driver_class = getattr(module, class_name)
+
+        available = getattr(driver_class, "available", True)
+        unavailable_reason = getattr(driver_class, "unavailable_reason", None)
+
+        # Read module file to detect imports
+        module_file = Path(module.__file__)
+        with open(module_file, "r", encoding="utf-8") as f:
+            content = f.read()
+
+        dependencies = _detect_dependencies_from_content(content, class_name)
+        dep_status = _check_dependency_status(dependencies)
+
+        return {
+            "name": class_name,
+            "available": available,
+            "reason": unavailable_reason,
+            "dependencies": dep_status,
+        }
+
+    except (ImportError, AttributeError) as e:
+        return {
+            "name": class_name,
+            "module": module_path,
+            "available": False,
+            "reason": str(e),
+            "dependencies": ["❌ Module not found"],
+        }
+
+
+def get_driver_info():
+    """Get information about all available drivers."""
+    drivers = []
+
+    # Define known driver modules
+    driver_modules = [
+        ("janito.drivers.openai.driver", "OpenAIModelDriver"),
+        ("janito.drivers.azure_openai.driver", "AzureOpenAIModelDriver"),
+        ("janito.drivers.zai.driver", "ZAIModelDriver"),
+        ("janito.drivers.cerebras.driver", "CerebrasModelDriver"),
+    ]
+
+    for module_path, class_name in driver_modules:
+        driver_info = _get_single_driver_info(module_path, class_name)
+        drivers.append(driver_info)
+
+    return drivers
+
+
+def _create_driver_table(drivers):
+    """Create and populate the drivers table."""
+    table = Table(title="Available LLM Drivers")
+    table.add_column("Driver", style="cyan", no_wrap=True)
+    table.add_column("Status", style="bold")
+    table.add_column("Dependencies", style="yellow")
+
+    for driver in drivers:
+        name = driver["name"]
+
+        if driver["available"]:
+            status = "[green]✅ Available[/green]"
+            if driver["reason"]:
+                status = f"[yellow]⚠️ Available ({driver['reason']})[/yellow]"
+        else:
+            status = f"[red]❌ Unavailable[/red]"
+            if driver["reason"]:
+                status = f"[red]❌ {driver['reason']}[/red]"
+
+        deps = "\n".join(driver["dependencies"])
+        table.add_row(name, status, deps)
+
+    return table
+
+
+def _get_missing_dependencies(drivers):
+    """Get list of missing dependencies."""
+    missing_deps = []
+    for driver in drivers:
+        for dep_status in driver["dependencies"]:
+            if dep_status.startswith("❌"):
+                dep_name = dep_status.split()[1]
+                if dep_name not in missing_deps:
+                    missing_deps.append(dep_name)
+    return missing_deps
+
+
+def handle_list_drivers(args=None):
+    """List all available LLM drivers with their status and dependencies."""
+    drivers = get_driver_info()
+
+    if not drivers:
+        console.print("[red]No drivers found[/red]")
+        return
+
+    table = _create_driver_table(drivers)
+    console.print(table)
+
+    # Installation help - only show for missing dependencies
+    missing_deps = _get_missing_dependencies(drivers)
+    if missing_deps:
+        console.print(
+            f"\n[dim]💡 Install missing deps: pip install {' '.join(missing_deps)}[/dim]"
+        )
+
+
+if __name__ == "__main__":
+    handle_list_drivers()

janito-2.17.0/janito/cli/cli_commands/list_providers_region.py

@@ -0,0 +1,85 @@
+"""
+CLI Command: List providers with their regional API information
+"""
+
+import json
+from typing import Dict, List
+from rich.console import Console
+from rich.table import Table
+from rich.panel import Panel
+
+from janito.regions.provider_regions import PROVIDER_REGIONS, get_all_providers
+from janito.regions.geo_utils import get_region_info
+
+console = Console()
+
+
+def handle_list_providers_region(args=None):
+    """List all providers with their regional API information."""
+
+    # Get user location info
+    user_info = get_region_info()
+    user_region = user_info["major_region"]
+
+    # Get all providers
+    providers = get_all_providers()
+
+    # Create table
+    table = Table(title="LLM Providers by Region")
+    table.add_column("Provider", style="cyan", no_wrap=True)
+    table.add_column("Region", style="green")
+    table.add_column("Endpoint", style="bright_white")
+
+    for provider in sorted(providers):
+        regions = PROVIDER_REGIONS.get(provider, [])
+        if not regions:
+            table.add_row(provider, "N/A", "N/A", "N/A", "N/A")
+            continue
+
+        # Find the best region for the user
+        best_region = None
+        for region in regions:
+            if region.region_code.startswith(user_region):
+                best_region = region
+                break
+
+        # If no exact match, use first available
+        if not best_region:
+            best_region = regions[0]
+
+        # Extract 2-letter region code
+        if provider == "azure-openai":
+            region_code = "ALL"
+        else:
+            region_code = (
+                user_region
+                if any(r.region_code.startswith(user_region) for r in regions)
+                else (
+                    "APAC"
+                    if best_region.region_code == "ASIA-PACIFIC"
+                    else best_region.region_code[:2]
+                )
+            )
+
+        table.add_row(
+            provider,
+            region_code,
+            best_region.endpoint,
+        )
+
+    console.print(table)
+
+    # Show user location info
+    console.print(
+        f"\n[dim]Your location: {user_info['country_code']} ({user_region})[/dim]"
+    )
+    console.print(f"[dim]Detection source: {user_info['source']}[/dim]")
+
+    # Show region mapping info
+    console.print(
+        "\n[dim]Regions: US (United States), EU (Europe), CN (China), CH (Switzerland), APAC (Asia Pacific)[/dim]"
+    )
+
+
+if __name__ == "__main__":
+    handle_list_providers_region()