janito 1.0.1__py3-none-any.whl → 1.2.0__py3-none-any.whl

janito/__init__.py

@@ -1 +1 @@
-__version__ = "1.0.1"
+__version__ = "1.2.0"

janito/agent/config.py

@@ -59,7 +59,7 @@ class FileConfig(BaseConfig):
 
 CONFIG_OPTIONS = {
     "api_key": "API key for OpenAI-compatible service (required)",
-    "model": "Model name to use (e.g., 'openrouter/optimus-alpha')",
+    "model": "Model name to use (e.g., 'openai/gpt-4.1')",
     "base_url": "API base URL (OpenAI-compatible endpoint)",
     "role": "Role description for the system prompt (e.g., 'software engineer')",
     "system_prompt": "Override the entire system prompt text",

janito/agent/config_defaults.py

@@ -1,7 +1,7 @@
 # Centralized config defaults for Janito
 CONFIG_DEFAULTS = {
     "api_key": None,  # Must be set by user
-    "model": "openrouter/optimus-alpha",    # Default model
+    "model": "openai/gpt-4.1",    # Default model
     "base_url": "https://openrouter.ai/api/v1",
     "role": "software engineer",
     "system_prompt": None,  # None means auto-generate from role

janito/agent/conversation.py

@@ -31,6 +31,12 @@ class ConversationHandler:
         if resolved_max_tokens is None:
             resolved_max_tokens = unified_config.get('max_tokens', 200000)
 
+        # Ensure max_tokens is always an int (handles config/CLI string values)
+        try:
+            resolved_max_tokens = int(resolved_max_tokens)
+        except (TypeError, ValueError):
+            raise ValueError(f"max_tokens must be an integer, got: {resolved_max_tokens!r}")
+
         for _ in range(max_rounds):
             if spinner:
                                 # Calculate word count for all messages

janito/agent/tool_handler.py

@@ -45,9 +45,10 @@ class ToolHandler:
         }
         return func
 
-    def __init__(self, verbose=False):
+    def __init__(self, verbose=False, enable_tools=True):
         self.verbose = verbose
         self.tools = []
+        self.enable_tools = enable_tools
 
     def register(self, func):
         self.tools.append(func)
@@ -57,6 +58,8 @@ class ToolHandler:
         return self.tools
 
     def get_tool_schemas(self):
+        if not getattr(self, 'enable_tools', True):
+            return []
         schemas = []
         for name, entry in self._tool_registry.items():
             schemas.append({

janito/cli/_print_config.py

@@ -62,7 +62,7 @@ def print_full_config(local_config, global_config, unified_config, config_defaul
             template_path = Path(__file__).parent.parent / "templates" / "system_instructions.j2"
             for key, value in default_items.items():
                 if key == "system_prompt" and value is None:
-                    out(f"{key} = file: {home_shorten(str(template_path))}")
+                    out(f"{key} = (default template path: {home_shorten(str(template_path))})")
                 else:
                     out(f"{key} = {value}")
             out("")

janito/cli/arg_parser.py

@@ -5,14 +5,21 @@ def create_parser():
     parser = argparse.ArgumentParser(description="OpenRouter API call using OpenAI Python SDK")
     parser.add_argument("prompt", type=str, nargs="?", help="Prompt to send to the model")
     parser.add_argument("--max-tokens", type=int, default=None, help="Maximum tokens for model response (overrides config, default: 200000)")
-    parser.add_argument("-s", "--system-prompt", type=str, default=None, help="Optional system prompt")
-    parser.add_argument("-r", "--role", type=str, default=None, help="Role description for the system prompt")
+    parser.add_argument("--model", type=str, default=None, help="Model name to use for this session (overrides config, does not persist)")
+
+    # Mutually exclusive group for system prompt options
+    group = parser.add_mutually_exclusive_group()
+    group.add_argument("-s", "--system-prompt", type=str, default=None, help="Optional system prompt as a raw string.")
+    group.add_argument("--system-file", type=str, default=None, help="Path to a plain text file to use as the system prompt (no template rendering, takes precedence over --system-prompt)")
+
+    parser.add_argument("-r", "--role", type=str, default=None, help="Role description for the default system prompt")
     parser.add_argument("-t", "--temperature", type=float, default=None, help="Sampling temperature (e.g., 0.0 - 2.0)")
     parser.add_argument("--verbose-http", action="store_true", help="Enable verbose HTTP logging")
     parser.add_argument("--verbose-http-raw", action="store_true", help="Enable raw HTTP wire-level logging")
     parser.add_argument("--verbose-response", action="store_true", help="Pretty print the full response object")
     parser.add_argument("--show-system", action="store_true", help="Show model, parameters, system prompt, and tool definitions, then exit")
     parser.add_argument("--verbose-tools", action="store_true", help="Print tool call parameters and results")
+    parser.add_argument("--disable-tools", action="store_true", default=False, help="Disable tool use (default: enabled)")
     parser.add_argument("--set-local-config", type=str, default=None, help='Set a local config key-value pair, format "key=val"')
     parser.add_argument("--set-global-config", type=str, default=None, help='Set a global config key-value pair, format "key=val"')
     parser.add_argument("--show-config", action="store_true", help="Show effective configuration and exit")

janito/cli/config_commands.py

@@ -103,7 +103,7 @@ def handle_config_commands(args):
                 if key == "system_prompt" and value is None:
                     from pathlib import Path
                     template_path = Path(__file__).parent.parent / "templates" / "system_instructions.j2"
-                    print(f"{key} = file: {home_shorten(str(template_path))}")
+                    print(f"{key} = (default template path: {home_shorten(str(template_path))})")
                 else:
                     print(f"{key} = {value}")
             print()

janito/cli/runner.py

@@ -34,14 +34,31 @@ def run_cli(args):
     # Ensure runtime_config is updated so chat shell sees the role
     if args.role:
         runtime_config.set('role', args.role)
-    # if args.role:
-    #     runtime_config.set('role', args.role)
-    system_prompt = args.system_prompt or unified_config.get("system_prompt")
-    if system_prompt is None:
-        system_prompt = render_system_prompt(role)
+
+    # Set runtime_config['model'] if --model is provided (highest priority, session only)
+    if getattr(args, 'model', None):
+        runtime_config.set('model', args.model)
+
+    # New logic for --system-file
+    system_prompt = None
+    if getattr(args, 'system_file', None):
+        try:
+            with open(args.system_file, 'r', encoding='utf-8') as f:
+                system_prompt = f.read()
+            runtime_config.set('system_prompt_file', args.system_file)
+        except Exception as e:
+            print(f"[red]Failed to read system prompt file:[/red] {e}")
+            sys.exit(1)
+    else:
+        system_prompt = args.system_prompt or unified_config.get("system_prompt")
+        if args.system_prompt:
+            runtime_config.set('system_prompt', system_prompt)
+        if system_prompt is None:
+            system_prompt = render_system_prompt(role)
 
     if args.show_system:
         api_key = get_api_key()
+        # Always get model from unified_config (which checks runtime_config first)
         model = unified_config.get('model')
         agent = Agent(api_key=api_key, model=model)
         print("Model:", agent.model)
@@ -52,37 +69,20 @@ def run_cli(args):
 
     api_key = get_api_key()
 
+    # Always get model from unified_config (which checks runtime_config first)
     model = unified_config.get('model')
     base_url = unified_config.get('base_url', 'https://openrouter.ai/api/v1')
-    agent = Agent(api_key=api_key, model=model, system_prompt=system_prompt, verbose_tools=args.verbose_tools, base_url=base_url)
+    # Handle --enable-tools flag
+    from janito.agent.tool_handler import ToolHandler
+    tool_handler = ToolHandler(verbose=args.verbose_tools, enable_tools=not getattr(args, 'disable_tools', False))
+    agent = Agent(api_key=api_key, model=model, system_prompt=system_prompt, verbose_tools=args.verbose_tools, base_url=base_url, tool_handler=tool_handler)
 
     # Save runtime max_tokens override if provided
     if args.max_tokens is not None:
         runtime_config.set('max_tokens', args.max_tokens)
-    if not args.prompt:
-        console = Console()
-
-        if not getattr(args, 'continue_session', False):
-            save_path = os.path.join('.janito', 'last_conversation.json')
-            if os.path.exists(save_path):
-                try:
-                    with open(save_path, 'r', encoding='utf-8') as f:
-                        data = json.load(f)
-                    messages = data.get('messages', [])
-                    num_messages = len(messages)
-                    console.print(f"[bold yellow]A previous conversation with {num_messages} messages was found.[/bold yellow]")
-
-                    last_usage_info = data.get('last_usage_info')
-                    if last_usage_info:
-                        prompt_tokens = last_usage_info.get('prompt_tokens', 0)
-                        completion_tokens = last_usage_info.get('completion_tokens', 0)
-                        total_tokens = prompt_tokens + completion_tokens
-                        console.print(Rule(f"Token usage - Prompt: {format_tokens(prompt_tokens)}, Completion: {format_tokens(completion_tokens)}, Total: {format_tokens(total_tokens)}"))
-
-                    console.print("You can resume it anytime by typing [bold]/continue[/bold].")
-                except Exception:
-                    pass  # Fail silently if file is corrupt or unreadable
 
+    # If no prompt is provided, enter shell loop mode
+    if not getattr(args, 'prompt', None):
         from janito.cli_chat_shell.chat_loop import start_chat_shell
         start_chat_shell(agent, continue_session=getattr(args, 'continue_session', False))
         sys.exit(0)
@@ -91,14 +91,8 @@ def run_cli(args):
 
     console = Console()
 
-    waiting_displayed = [True]
-
     def on_content(data):
         content = data.get("content", "")
-        if waiting_displayed[0]:
-            # Clear the waiting message
-            sys.stdout.flush()
-            waiting_displayed[0] = False
         console.print(Markdown(content))
 
     messages = []
@@ -117,22 +111,11 @@ def run_cli(args):
             if args.verbose_response:
                 import json
                 console.print_json(json.dumps(response))
-
-            usage = response.get('usage')
-            if usage:
-                prompt_tokens = usage.get('prompt_tokens')
-                completion_tokens = usage.get('completion_tokens')
-                total_tokens = usage.get('total_tokens')
-                console.print(Rule(f"Token usage - Prompt: {format_tokens(prompt_tokens)}, Completion: {format_tokens(completion_tokens)}, Total: {format_tokens(total_tokens)}"))
         except MaxRoundsExceededError:
-            print("[Error] Conversation exceeded maximum rounds.")
-            sys.exit(1)
+            print("[red]Max conversation rounds exceeded.[/red]")
         except ProviderError as e:
-            print(f"[Error] Provider error: {e}")
-            sys.exit(1)
+            print(f"[red]Provider error:[/red] {e}")
         except EmptyResponseError as e:
-            print(f"[Error] {e}")
-            sys.exit(1)
+            print(f"[red]Error:[/red] {e}")
     except KeyboardInterrupt:
-        print("\n[Interrupted by user]")
-        sys.exit(1)
+        console.print("[yellow]Interrupted by user.[/yellow]")

janito/cli_chat_shell/chat_loop.py

@@ -69,7 +69,7 @@ def start_chat_shell(agent, continue_session=False):
     session = get_prompt_session(
         get_toolbar_func(
             get_messages, get_usage, get_elapsed, model_name=model_name,
-            role_ref=lambda: runtime_config.get('role') or effective_config.get('role')
+            role_ref=lambda: ("*using custom system prompt*" if (runtime_config.get('system_prompt') or runtime_config.get('system_prompt_file')) else (runtime_config.get('role') or effective_config.get('role')))
         ),
         mem_history
     )

janito/templates/system_instructions.j2

@@ -1,6 +1,6 @@
 You are a helpful {{ role }}.
 
-When using tools, please describe the purpose before calling them.
+You will start every response with a concise plan on how to gather additional information.
 
 <context>
 Always review `docs/structure.md` before conducting file-specific searches.

janito-1.2.0.dist-info/METADATA

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: janito
+Version: 1.2.0
+Summary: An agent framework with built-in tools.
+Author-email: João Pinto <joao.pinto@gmail.com>
+License: MIT
+Project-URL: homepage, https://github.com/joaompinto/janito
+Project-URL: repository, https://github.com/joaompinto/janito
+Keywords: agent,framework,tools,automation
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich
+Requires-Dist: openai
+Requires-Dist: flask
+Requires-Dist: pathspec
+Requires-Dist: beautifulsoup4
+Dynamic: license-file
+
+# 🚀 Janito: Natural Language Code Editing Agent
+
+## ⚡ Quick Start
+
+Run a one-off prompt:
+```bash
+python -m janito "Refactor the data processing module to improve readability."
+```
+
+Or start the interactive chat shell:
+```bash
+python -m janito
+```
+
+Launch the web UI:
+```bash
+python -m janito.web
+```
+
+---
+
+Janito is a command-line and web-based AI agent designed to **edit code and manage files** using natural language instructions.
+
+---
+
+## ✨ Key Features
+- 📝 **Code Editing via Natural Language:** Modify, create, or delete code files simply by describing the changes.
+- 📁 **File & Directory Management:** Navigate, create, move, or remove files and folders.
+- 🧠 **Context-Aware:** Understands your project structure for precise edits.
+- 💬 **Interactive User Prompts:** Asks for clarification when needed.
+- 🧩 **Extensible Tooling:** Built-in tools for file operations, shell commands, and more.
+- 🌐 **Web Interface (In Development):** Upcoming simple web UI for streaming responses and tool progress.
+
+---
+
+## 📦 Installation
+
+### Requirements
+- Python 3.8+
+
+...
+
+### Configurable Options
+
+| Key                 | Description                                                                                 | How to set                                                      | Default                                    |
+|---------------------|---------------------------------------------------------------------------------------------|-----------------------------------------------------------------|--------------------------------------------|
+| `api_key`           | API key for OpenAI-compatible service                                                       | `--set-api-key`, config file                                    | _None_ (required)                          |
+| `model`             | Model name to use                                                                           | `--model` (session only), `--set-local-config model=...`, or `--set-global-config`         | `openai/gpt-4.1`                 |
+| `base_url`          | API base URL (OpenAI-compatible endpoint)                                                   | `--set-local-config base_url=...` or `--set-global-config`      | `https://openrouter.ai/api/v1`            |
+| `role`              | Role description for system prompt                                                          | CLI `--role` or config                                          | "software engineer"                     |
+| `system_prompt`     | Override the entire system prompt as a raw string.                                          | CLI `--system-prompt` or config                                 | _Template-generated prompt_               |
+| `system_prompt_file`| Use a plain text file as the system prompt (no template rendering, takes precedence over `system_prompt`). | CLI `--system-file` | _None_ |
+| `temperature`       | Sampling temperature (float, e.g., 0.0 - 2.0)                                              | CLI `--temperature` or config                                    | 0.2                                        |
+| `max_tokens`        | Maximum tokens for model response                                                          | CLI `--max-tokens` or config                                    | 200000                                     |
+| `disable_tools`     | Disable tool use (no tools passed to agent)                                                | CLI `--disable-tools`                                            | _False_                                     |
+
+#### System Prompt Precedence
+
+- If `--system-file` is provided, the file's content is used as the system prompt (no template rendering).
+- Otherwise, if `--system-prompt` or the config value is set, that string is used.
+- Otherwise, a default template is rendered using the current role.
+
+...

{janito-1.0.1.dist-info → janito-1.2.0.dist-info}/RECORD

@@ -1,14 +1,14 @@
-janito/__init__.py,sha256=j9q3lYMZra0QrErNnn9E5GNXxWLOlDgeOkmX8oXa7ro,23
+janito/__init__.py,sha256=El1sbpINO-cJ2mX6y_07W6DCl7IpRhkDNz3fpZpHII0,23
 janito/__main__.py,sha256=CBScR30Tm-vuhIJM8o5HXKr0q-smICiwSVyuU68BP8U,78
 janito/render_prompt.py,sha256=HrMUELV4tI3PWqv6RM6teiVvnUejdehBcnHUFzit3Bo,445
 janito/agent/__init__.py,sha256=CByAH5Yk-yH64zo0RU7Z3nsn_7Vmandphqk0JNlpyj8,21
 janito/agent/agent.py,sha256=qGjkGajNjroz1kU-iV--0DD_2FwmwjAM1Y9Z5foxwoE,3590
-janito/agent/config.py,sha256=6WQbjrK-UwkG9Yb5e5ljfBIvQs3Y_Wgd3Py8FbO0RiI,3565
-janito/agent/config_defaults.py,sha256=cR4kFkjg6BFccE0psy4khBiKjnj60VCQhmqLvLbjcJM,373
-janito/agent/conversation.py,sha256=5UtWgDsRh205p0Dq8tEtqEPT0avL8KFs3xmwJomaYEk,4664
+janito/agent/config.py,sha256=-zespUJrFb61fyJzjemont6lirnPM_FF88NUiTVI91I,3555
+janito/agent/config_defaults.py,sha256=Ow-LKq88MmMTQ6LDH_u26NqJ8-db35KpcfR8FYuWGBw,363
+janito/agent/conversation.py,sha256=Q3sXqzKgQalr9SD8D4dJnCbe_EmklAobx_29mwYhJhE,4956
 janito/agent/queued_tool_handler.py,sha256=THPymKXnpoXfN49EhW5b4hrwpWZZup73JKFDJ_U03tI,540
 janito/agent/runtime_config.py,sha256=gigcKUwaXs_qSdXdC5InUTPmdXUbOA-tRUx2ZJ5zzI0,906
-janito/agent/tool_handler.py,sha256=f3iOWi78bKn0B6twMlayedmE0OMeQ1do32yZl4DMzaE,4399
+janito/agent/tool_handler.py,sha256=MiwGx6Wlasan6KO3-Q0UDEJjmtDavd7ITc0gVjfa47s,4536
 janito/agent/tools/__init__.py,sha256=7-RjFK1YXacifjSrXT4EdMXG_kyKVl7TCjrcHkklaCQ,414
 janito/agent/tools/ask_user.py,sha256=MHKHyBTD4iyCM-z9_ZUbe7AMn-pz7cr6FIAB0SdESH4,1895
 janito/agent/tools/bash_exec.py,sha256=1HkjvTlXunjZ7xvxqzdayG8JWtrioC0MYOfdid_6uiY,2486
@@ -25,27 +25,27 @@ janito/agent/tools/rich_utils.py,sha256=aQMqeaq3hIpzZ5EHQBNTKS5dNsojQp9MDfJSoqOQ
 janito/agent/tools/search_text.py,sha256=TdTpaomLt4oZpX_0zz9W_bXhI5vvQLu0IjA7mCRCJYU,2020
 janito/agent/tools/view_file.py,sha256=i4IBpn_Waw_4sgHUOaPIYPcMNmmvzM9ECoR5O5fldfU,1535
 janito/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-janito/cli/_print_config.py,sha256=gsdVgG8uGHoWZHUSzgvB-FIrlvAawF0HjXtiQZAloPk,3116
+janito/cli/_print_config.py,sha256=s6A-khfChmIQYRpYteokbXHlZ9VfIphdsnmABIYk_b4,3135
 janito/cli/_utils.py,sha256=Q_OCFZmbr78qW4hSSUUhjondVc0ao7-iUHE7Ig8IP1g,289
-janito/cli/arg_parser.py,sha256=6Y_gBJSPk7tdHKSAsi1fQdr4pnCp8dcSGFrlu7s8KiI,2498
-janito/cli/config_commands.py,sha256=Ovk2LszVrHcKSqXjlH-fvJYhT3axZomlh9_wpNQfSYI,5675
+janito/cli/arg_parser.py,sha256=kMQAstvPldkwYrXjuWwp6lYfuQCl1NLrridFtyI75_g,3089
+janito/cli/config_commands.py,sha256=WQKHt3iIdjRiAKmi-dnOSLFybF-HSc93zYoWd2aZcTU,5694
 janito/cli/logging_setup.py,sha256=dWQ0wFf4YuF5lxZlhpN6lis7G56LeFYUwQdh9nA5NmA,1141
 janito/cli/main.py,sha256=ONmn_lIPu8_Rd57j3YfWEx46fWj8gAkONPLdctABwy0,1333
-janito/cli/runner.py,sha256=K_xpygfg4MpyLuI6hx3s1I6-leEd80w08l3F6PIO4so,5362
+janito/cli/runner.py,sha256=fzHdH3Vb4CoyOGDH6h74xKIOPKrUJJ3yRDlScsWJhqE,4481
 janito/cli_chat_shell/__init__.py,sha256=PDGl7xK_vgkROoXvUxGZqVQFfuL9U4TjdexpP8E2JKg,41
-janito/cli_chat_shell/chat_loop.py,sha256=KjnmhOYU0zblBzV5Q80BCqgvKSi_rPpE3TykzzDoexk,5259
+janito/cli_chat_shell/chat_loop.py,sha256=yPqQLEUwuzmtymmBLOwYSLd52ixRKL_C-ZK7vGYaNug,5384
 janito/cli_chat_shell/commands.py,sha256=Tvhw8azybchGS1qi2yJEn3FKho-FDYOK1ZT865GYwhM,7615
 janito/cli_chat_shell/config_shell.py,sha256=s59PCt_TmBPqQJ_C8nkKo4kCcW9aq3Jhpe9RlRCa0-s,3265
 janito/cli_chat_shell/load_prompt.py,sha256=EuUlHg317T8f5VqEMaJxFgzWBl51zC2sND0eeYr6pJ4,612
 janito/cli_chat_shell/session_manager.py,sha256=Gax0pC0ediDsExLUwPEg_nD8MdSrznaHoer53zxLYuE,1966
 janito/cli_chat_shell/ui.py,sha256=7O36dWaXDQ5r-GGD6a57iHSiDpN2pkdav3HxSdf6CIc,5279
-janito/templates/system_instructions.j2,sha256=f-hRp0ZliGac8vg6HJiYkU0TketpFoSbUunh9TOQrtE,1795
+janito/templates/system_instructions.j2,sha256=JnR_nSbQrT5kfLeOwLgnvOV-x9N2msndj2HjDtEYRQw,1819
 janito/web/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 janito/web/__main__.py,sha256=oPXNF332aCeI7aUWr7_8M57oOKugw422VrEubxFp0P4,354
 janito/web/app.py,sha256=bZse9S_F9hFSYRTJxoel5RjrtoAmvJ_lYkPfKRmBI1o,4125
-janito-1.0.1.dist-info/licenses/LICENSE,sha256=sHBqv0bvtrb29H7WRR-Z603YHm9pLtJIo3nHU_9cmgE,1091
-janito-1.0.1.dist-info/METADATA,sha256=NcSx21pY78wR4NzupbiIuEc0srPMn9nToBpLFbKZQjM,5103
-janito-1.0.1.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-janito-1.0.1.dist-info/entry_points.txt,sha256=wIo5zZxbmu4fC-ZMrsKD0T0vq7IqkOOLYhrqRGypkx4,48
-janito-1.0.1.dist-info/top_level.txt,sha256=m0NaVCq0-ivxbazE2-ND0EA9Hmuijj_OGkmCbnBcCig,7
-janito-1.0.1.dist-info/RECORD,,
+janito-1.2.0.dist-info/licenses/LICENSE,sha256=sHBqv0bvtrb29H7WRR-Z603YHm9pLtJIo3nHU_9cmgE,1091
+janito-1.2.0.dist-info/METADATA,sha256=Wyag2PcH7RCSx4YbQNFbrRrwmwOJOHg5js_se0niiNs,4664
+janito-1.2.0.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+janito-1.2.0.dist-info/entry_points.txt,sha256=wIo5zZxbmu4fC-ZMrsKD0T0vq7IqkOOLYhrqRGypkx4,48
+janito-1.2.0.dist-info/top_level.txt,sha256=m0NaVCq0-ivxbazE2-ND0EA9Hmuijj_OGkmCbnBcCig,7
+janito-1.2.0.dist-info/RECORD,,

janito-1.0.1.dist-info/METADATA

@@ -1,144 +0,0 @@
-Metadata-Version: 2.4
-Name: janito
-Version: 1.0.1
-Summary: An agent framework with built-in tools.
-Author-email: João Pinto <joao.pinto@gmail.com>
-License: MIT
-Project-URL: homepage, https://github.com/joaompinto/janito
-Project-URL: repository, https://github.com/joaompinto/janito
-Keywords: agent,framework,tools,automation
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: rich
-Requires-Dist: openai
-Requires-Dist: flask
-Requires-Dist: pathspec
-Dynamic: license-file
-
-# 🚀 Janito: Natural Language Code Editing Agent
-
-## ⚡ Quick Start
-
-Run a one-off prompt:
-```bash
-python -m janito "Refactor the data processing module to improve readability."
-```
-
-Or start the interactive chat shell:
-```bash
-python -m janito
-```
-
-Launch the web UI:
-```bash
-python -m janito.web
-```
-
----
-
-Janito is a command-line and web-based AI agent designed to **edit code and manage files** using natural language instructions.
-
----
-
-## ✨ Key Features
-- 📝 **Code Editing via Natural Language:** Modify, create, or delete code files simply by describing the changes.
-- 📁 **File & Directory Management:** Navigate, create, move, or remove files and folders.
-- 🧠 **Context-Aware:** Understands your project structure for precise edits.
-- 💬 **Interactive User Prompts:** Asks for clarification when needed.
-- 🧩 **Extensible Tooling:** Built-in tools for file operations, shell commands, and more.
-- 🌐 **Web Interface (In Development):** Upcoming simple web UI for streaming responses and tool progress.
-
----
-
-## 📦 Installation
-
-### Requirements
-- Python 3.8+
-
-### Install dependencies
-```bash
-pip install -e .
-```
-
-### Set your API key
-Janito uses OpenAI-compatible APIs (default: `openrouter/optimus-alpha`). Set your API key using the CLI:
-```bash
-python -m janito --set-api-key your_api_key_here
-```
-
-### Obtain an API key from openrouter.io
-1. Visit [https://openrouter.io/](https://openrouter.io/)
-2. Sign in or create a free account.
-3. Navigate to **API Keys** in your account dashboard.
-4. Click **Create new key**, provide a name, and save the generated key.
-5. Save it using the CLI:
-```bash
-python -m janito --set-api-key your_api_key_here
-```
-
----
-
-## ⚙️ Configuration
-
-Janito supports multiple ways to configure API access, model, and behavior:
-
-### API Key
-
-- Set via CLI:
-  ```bash
-  python -m janito --set-api-key your_api_key_here
-  ```
-
-### Configurable Options
-
-| Key             | Description                                               | How to set                                                      | Default                                    |
-|-----------------|-----------------------------------------------------------|-----------------------------------------------------------------|--------------------------------------------|
-| `api_key`       | API key for OpenAI-compatible service                     | `--set-api-key`, config file                                    | _None_ (required)                          |
-| `model`         | Model name to use                                         | `--set-local-config model=...` or `--set-global-config`         | `openrouter/optimus-alpha`                 |
-| `base_url`      | API base URL (OpenAI-compatible endpoint)                 | `--set-local-config base_url=...` or `--set-global-config`      | `https://openrouter.ai/api/v1`            |
-| `role`          | Role description for system prompt                        | CLI `--role` or config                                          | "software engineer"                     |
-| `system_prompt` | Override the entire system prompt                         | CLI `--system-prompt` or config                                 | _Template-generated prompt_               |
-| `temperature`   | Sampling temperature (float, e.g., 0.0 - 2.0)            | CLI `--temperature` or config                                    | 0.2                                        |
-| `max_tokens`    | Maximum tokens for model response                        | CLI `--max-tokens` or config                                    | 200000                                     |
-
-### Config files
-
-- **Local config:** `.janito/config.json` (project-specific)
-- **Global config:** `~/.config/janito/config.json` (user-wide)
-
-Set values via:
-
-```bash
-python -m janito --set-local-config key=value
-python -m janito --set-global-config key=value
-```
-
----
-
-## 🚀 Build and Release
-
-Janito provides scripts for automated build and release to PyPI:
-
-### Bash (Linux/macOS)
-
-```bash
-./tools/release.sh
-```
-
-### PowerShell (Windows)
-
-```powershell
-./tools/release.ps1
-```
-
-These scripts will:
-- Check for required tools (`hatch`, `twine`)
-- Validate the version in `pyproject.toml` against PyPI and git tags
-- Build the package
-- Upload to PyPI
-
----