ai-toolkit-cli 0.1.0__tar.gz

ai_toolkit_cli-0.1.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: ai-toolkit-cli
+Version: 0.1.0
+Requires-Dist: typer
+Requires-Dist: rich
+Requires-Dist: openai
+Requires-Dist: python-dotenv

ai_toolkit_cli-0.1.0/README.md

@@ -0,0 +1,52 @@
+# ai-toolkit
+
+`ai-toolkit` is a small Typer-based command-line app for AI-assisted terminal workflows.
+
+## Commands
+
+The CLI is organized into three command groups:
+
+- `chat`
+- `code`
+- `summarize`
+
+The top-level entry point is `ai`.
+
+## Project Layout
+
+- `main.py` - Typer application and command registration
+- `commands/` - command group modules
+- `core/` - client and configuration helpers
+- `utils/` - shared formatting helpers
+
+## Requirements
+
+The project currently depends on:
+
+- `typer`
+- `rich`
+- `openai`
+- `python-dotenv`
+
+## Setup
+
+1. Create and activate a Python 3.12 virtual environment.
+2. Install the project dependencies.
+3. Run the CLI help to verify the app loads.
+
+Example:
+
+```bash
+python -m venv .venv
+.venv\Scripts\activate
+pip install -e .
+ai --help
+```
+
+## Environment
+
+Store local configuration in a `.env` file. Keep API keys and machine-specific values out of version control.
+
+## Notes
+
+The repository is still in an early stage, so command modules and supporting helpers are intentionally lightweight. Add usage examples here as the CLI grows.

ai_toolkit_cli-0.1.0/ai_toolkit/commands/chat.py

@@ -0,0 +1,49 @@
+import typer
+import time
+import threading
+import os
+import shutil
+from ai_toolkit.core.client import ask
+
+os.system("")  # enable ANSI on Windows
+
+app = typer.Typer()
+
+SPINNER_FRAMES = ["⣾", "⣽", "⣻", "⢿", "⡿", "⣟", "⣯", "⣷"]
+
+def spinning(stop_event):
+    i = 0
+    while not stop_event.is_set():
+        frame = SPINNER_FRAMES[i % len(SPINNER_FRAMES)]
+        print(f"\r\033[96m  {frame} Thinking...\033[0m", end="", flush=True)
+        time.sleep(0.08)
+        i += 1
+    print("\r" + " " * 30 + "\r", end="", flush=True)
+
+def typewriter(text: str):
+    print("\n\033[96m  ╔═ AI ════════════════════════════╗\033[0m")
+    print("  \033[97m", end="", flush=True)
+    for char in text:
+        print(char, end="", flush=True)
+        time.sleep(0.008)
+    print("\n\033[96m  ╚═════════════════════════════════╝\033[0m\n")
+
+@app.command()
+def ask_cmd(
+    question: str = typer.Argument(..., help="Question to ask the AI"),
+    model: str = typer.Option("minimax/minimax-m2.5:free", "--model", "-m"),
+):
+    """Ask the AI a question."""
+    response_holder = {}
+    stop_event = threading.Event()
+
+    def fetch():
+        response_holder["result"] = ask(question, model=model)
+        stop_event.set()
+
+    thread = threading.Thread(target=fetch)
+    thread.start()
+    spinning(stop_event)
+    thread.join()
+
+    typewriter(response_holder["result"])

ai_toolkit_cli-0.1.0/ai_toolkit/commands/codegen.py

@@ -0,0 +1,64 @@
+import typer
+import time
+import threading
+from rich.syntax import Syntax
+from rich.console import Console
+from ai_toolkit.core.client import ask
+
+app = typer.Typer()
+console = Console()
+
+SPINNER_FRAMES = ["⣾", "⣽", "⣻", "⢿", "⡿", "⣟", "⣯", "⣷"]
+
+
+def spinning(stop_event):
+    i = 0
+    while not stop_event.is_set():
+        frame = SPINNER_FRAMES[i % len(SPINNER_FRAMES)]
+        print(f"\r\033[96m  {frame} Generating code...\033[0m", end="", flush=True)
+        time.sleep(0.08)
+        i += 1
+    print("\r" + " " * 40 + "\r", end="", flush=True)
+
+
+@app.command(context_settings={"allow_extra_args": True, "ignore_unknown_options": True})
+def generate(
+    ctx: typer.Context,
+    lang: str = typer.Option("python", "--lang", "-l", help="Programming language"),
+    model: str = typer.Option("minimax/minimax-m2.5:free", "--model", "-m", help="Model to use"),
+):
+    """Generate code from a description."""
+    task = " ".join(ctx.args).strip()
+
+    if not task:
+        print("\n\033[38;5;213m  ✦  Usage:\033[0m  \033[38;5;240mai code generate <task> --lang python\033[0m\n")
+        raise typer.Exit()
+
+    prompt = f"Write {lang} code to: {task}. Return only the code, no explanation."
+
+    response_holder = {}
+    stop_event = threading.Event()
+
+    def fetch():
+        try:
+            response_holder["result"] = ask(prompt, model=model)
+        except Exception as e:
+            response_holder["result"] = f"# Error: {e}"
+        stop_event.set()
+
+    thread = threading.Thread(target=fetch)
+    thread.start()
+    spinning(stop_event)
+    thread.join()
+
+    code = response_holder.get("result", "# No response.")
+
+    # strip markdown fences if model returns them
+    if code.startswith("```"):
+        lines = code.split("\n")
+        code = "\n".join(lines[1:-1] if lines[-1].strip() == "```" else lines[1:])
+
+    print()
+    syntax = Syntax(code, lang, theme="monokai", line_numbers=True)
+    console.print(syntax)
+    print()

ai_toolkit_cli-0.1.0/ai_toolkit/commands/summarize.py

@@ -0,0 +1,65 @@
+import time
+import threading
+import typer
+from pathlib import Path
+from ai_toolkit.core.client import ask
+
+import os
+os.system("")  # enable ANSI on Windows
+
+app = typer.Typer()
+
+SPINNER_FRAMES = ["⣾", "⣽", "⣻", "⢿", "⡿", "⣟", "⣯", "⣷"]
+
+
+def spinning(stop_event):
+    i = 0
+    while not stop_event.is_set():
+        frame = SPINNER_FRAMES[i % len(SPINNER_FRAMES)]
+        print(f"\r\033[96m  {frame} Summarizing...\033[0m", end="", flush=True)
+        time.sleep(0.08)
+        i += 1
+    print("\r" + " " * 30 + "\r", end="", flush=True)
+
+
+def typewriter(text: str):
+    print("\n\033[96m  ╔═ AI ════════════════════════════╗\033[0m")
+    print("  \033[97m", end="", flush=True)
+    for char in text:
+        print(char, end="", flush=True)
+        time.sleep(0.008)
+    print("\n\033[96m  ╚═════════════════════════════════╝\033[0m\n")
+
+
+@app.command()
+def file(path: Path = typer.Argument(..., help="File to summarize")):
+    """Summarize a text file."""
+    content = path.read_text()
+
+    stop_event = threading.Event()
+    spinner_thread = threading.Thread(target=spinning, args=(stop_event,))
+    spinner_thread.start()
+
+    try:
+        summary = ask(f"Summarize this:\n\n{content}")
+    finally:
+        stop_event.set()
+        spinner_thread.join()
+
+    typewriter(summary)
+
+
+@app.command()
+def text(input: str = typer.Argument(...)):
+    """Summarize a string of text."""
+    stop_event = threading.Event()
+    spinner_thread = threading.Thread(target=spinning, args=(stop_event,))
+    spinner_thread.start()
+
+    try:
+        result = ask(f"Summarize: {input}")
+    finally:
+        stop_event.set()
+        spinner_thread.join()
+
+    typewriter(result)

ai_toolkit_cli-0.1.0/ai_toolkit/core/client.py

@@ -0,0 +1,22 @@
+import os
+from openai import OpenAI
+from dotenv import load_dotenv
+
+load_dotenv()
+
+def get_client():
+    return OpenAI(
+        api_key=os.environ["OPENROUTER_API_KEY"],
+        base_url="https://openrouter.ai/api/v1",
+    )
+
+def ask(prompt: str, system: str = "You are a helpful assistant.", model: str = "minimax/minimax-m2.5:free") -> str:
+    client = get_client()
+    response = client.chat.completions.create(
+        model=model,
+        messages=[
+            {"role": "system", "content": system},
+            {"role": "user", "content": prompt}
+        ]
+    )
+    return response.choices[0].message.content

ai_toolkit_cli-0.1.0/ai_toolkit/main.py

@@ -0,0 +1,54 @@
+import typer
+import time
+import os
+from ai_toolkit.commands import chat, summarize, codegen
+
+os.system("")  # enable ANSI on Windows
+
+def show_banner():
+    banner = """
+\033[96m  ╔══════════════════════════════════════════╗
+  ║                                          ║
+  ║  \033[94m █████╗ ██╗    ████████╗ ██████╗ \033[96m       ║
+  ║  \033[94m██╔══██╗██║       ██║   ██╔═══██╗\033[96m       ║
+  ║  \033[94m███████║██║       ██║   ██║   ██║\033[96m       ║
+  ║  \033[94m██╔══██║██║       ██║   ██║   ██║\033[96m       ║
+  ║  \033[94m██║  ██║███████╗  ██║   ╚██████╔╝\033[96m       ║
+  ║  \033[94m╚═╝  ╚═╝╚══════╝  ╚═╝    ╚═════╝ \033[96m       ║
+  ║                                          ║
+  ║  \033[97m🤖 AI Toolkit CLI  v1.0.0           \033[96m    ║
+  ║  \033[92m⚡ Powered by OpenRouter            \033[96m    ║
+  ║                                          ║
+  ╚══════════════════════════════════════════╝\033[0m"""
+
+    for line in banner.split("\n"):
+        print(line)
+        time.sleep(0.04)
+
+    tagline = "\n  → Type  ai --help  to get started\n"
+    print("\033[93m", end="", flush=True)
+    for char in tagline:
+        print(char, end="", flush=True)
+        time.sleep(0.03)
+    print("\033[0m")
+
+
+app = typer.Typer(
+    name="ai",
+    help="🤖 AI Toolkit CLI — powered by OpenRouter",
+    invoke_without_command=True,
+    no_args_is_help=False,  # ← important: don't show help when no args
+)
+
+@app.callback()
+def main(ctx: typer.Context = typer.Option(None, hidden=True, is_eager=True)):
+    if ctx.invoked_subcommand is None:
+        show_banner()
+        raise typer.Exit()
+
+app.add_typer(chat.app, name="chat")
+app.add_typer(summarize.app, name="summarize")
+app.add_typer(codegen.app, name="code")
+
+if __name__ == "__main__":
+    app()

ai_toolkit_cli-0.1.0/ai_toolkit_cli.egg-info/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: ai-toolkit-cli
+Version: 0.1.0
+Requires-Dist: typer
+Requires-Dist: rich
+Requires-Dist: openai
+Requires-Dist: python-dotenv

ai_toolkit_cli-0.1.0/ai_toolkit_cli.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+ai_toolkit/main.py
+ai_toolkit/commands/chat.py
+ai_toolkit/commands/codegen.py
+ai_toolkit/commands/summarize.py
+ai_toolkit/core/client.py
+ai_toolkit_cli.egg-info/PKG-INFO
+ai_toolkit_cli.egg-info/SOURCES.txt
+ai_toolkit_cli.egg-info/dependency_links.txt
+ai_toolkit_cli.egg-info/entry_points.txt
+ai_toolkit_cli.egg-info/requires.txt
+ai_toolkit_cli.egg-info/top_level.txt

ai_toolkit_cli-0.1.0/ai_toolkit_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ai_toolkit_cli-0.1.0/ai_toolkit_cli.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ai = ai_toolkit.main:app

ai_toolkit_cli-0.1.0/ai_toolkit_cli.egg-info/requires.txt

@@ -0,0 +1,4 @@
+typer
+rich
+openai
+python-dotenv

ai_toolkit_cli-0.1.0/ai_toolkit_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+ai_toolkit

ai_toolkit_cli-0.1.0/pyproject.toml

@@ -0,0 +1,11 @@
+[project]
+name = "ai-toolkit-cli"
+version = "0.1.0"
+dependencies = ["typer", "rich", "openai", "python-dotenv"]
+
+[project.scripts]
+ai = "ai_toolkit.main:app"
+
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"

ai_toolkit_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+