maverick-installer 0.1.2__tar.gz

maverick_installer-0.1.2/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: maverick-installer
+Version: 0.1.2
+Summary: Interactive setup wizard for Maverick
+Author: cdayAI
+License: MIT
+Project-URL: Homepage, https://github.com/cdayAI/maverick
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: maverick-agent>=0.1
+Requires-Dist: questionary>=2.0
+Requires-Dist: rich>=13.7
+
+# maverick-installer
+
+The interactive setup wizard. Installed as part of the kernel's
+`[installer]` extra:
+
+```bash
+pipx install 'maverick-agent[installer]'
+maverick init
+```
+
+If the kernel is already installed without the extra:
+
+```bash
+pipx inject maverick-agent maverick-installer
+```
+
+A standalone `maverick-init` entry point is also exposed (same flags).
+
+## Modes
+
+`maverick init` first asks how you want to set up:
+
+- **consumer** (default) — four questions (name, API key, working
+  directory, budget) with safe defaults. About a minute. This is what
+  the desktop GUI installer runs too, via the same code path.
+- **advanced** — pick every provider and per-role model, channels,
+  safety profile, sandbox backend, budget, capabilities, web search,
+  MCP servers, plugins, tool ACLs, rate limits, retention, persona,
+  and notifications.
+
+## Flags
+
+```bash
+maverick init --fast     # skip every prompt; write recommended defaults
+maverick init --resume   # resume an advanced run from the last unanswered question
+```
+
+Both flags work via `maverick init` and the standalone `maverick-init`.
+
+## Output
+
+Writes `~/.maverick/config.toml` (0o600) and, when you enter any keys,
+`~/.maverick/.env` (0o600). The agent reads from there. Re-running the
+wizard overwrites both.

maverick_installer-0.1.2/README.md

@@ -0,0 +1,44 @@
+# maverick-installer
+
+The interactive setup wizard. Installed as part of the kernel's
+`[installer]` extra:
+
+```bash
+pipx install 'maverick-agent[installer]'
+maverick init
+```
+
+If the kernel is already installed without the extra:
+
+```bash
+pipx inject maverick-agent maverick-installer
+```
+
+A standalone `maverick-init` entry point is also exposed (same flags).
+
+## Modes
+
+`maverick init` first asks how you want to set up:
+
+- **consumer** (default) — four questions (name, API key, working
+  directory, budget) with safe defaults. About a minute. This is what
+  the desktop GUI installer runs too, via the same code path.
+- **advanced** — pick every provider and per-role model, channels,
+  safety profile, sandbox backend, budget, capabilities, web search,
+  MCP servers, plugins, tool ACLs, rate limits, retention, persona,
+  and notifications.
+
+## Flags
+
+```bash
+maverick init --fast     # skip every prompt; write recommended defaults
+maverick init --resume   # resume an advanced run from the last unanswered question
+```
+
+Both flags work via `maverick init` and the standalone `maverick-init`.
+
+## Output
+
+Writes `~/.maverick/config.toml` (0o600) and, when you enter any keys,
+`~/.maverick/.env` (0o600). The agent reads from there. Re-running the
+wizard overwrites both.

maverick_installer-0.1.2/maverick_installer/__init__.py

@@ -0,0 +1,3 @@
+"""Maverick interactive installer."""
+
+__version__ = "0.1.2"

maverick_installer-0.1.2/maverick_installer/bridge.py

@@ -0,0 +1,124 @@
+"""Python sidecar for the Tauri desktop installer.
+
+Reads wizard steps from stdin, writes JSON-formatted next-step
+descriptors to stdout. The Tauri Rust shell drives this process and
+the Svelte UI sends user answers via Tauri invoke calls.
+
+Protocol (line-delimited JSON):
+
+  stdin:  <user_answer_string>  (empty string for first call)
+  stdout: {"id": "<step_id>", "question": "...", "choices": ["...", ...]}
+
+When the wizard is complete, sidecar emits ``{"id": "__done__", ...}``
+and exits.
+
+The four questions mirror the CLI's consumer mode exactly (name,
+sign-in key, working directory, budget) and the resulting config is
+written by the SAME ``write_consumer_config`` helper the CLI uses, so
+the GUI and CLI can't drift.
+"""
+from __future__ import annotations
+
+import json
+import os
+import sys
+from pathlib import Path
+from typing import Any
+
+from .wizard import write_consumer_config
+
+
+def _step(id: str, question: str, choices: list[str], *, kind: str = "choice") -> dict[str, Any]:
+    # `kind` lets the Svelte UI render the right control: a choice list,
+    # a free-text box, or a masked secret field.
+    return {"id": id, "question": question, "choices": choices, "kind": kind}
+
+
+def _send(step: dict[str, Any]) -> None:
+    sys.stdout.write(json.dumps(step) + "\n")
+    sys.stdout.flush()
+
+
+def _recv() -> str:
+    return sys.stdin.readline().strip()
+
+
+def run() -> None:
+    """Sidecar entry point: the four-question consumer flow.
+
+    Matches ``maverick_installer.wizard.run_consumer`` question for
+    question. No jargon, no provider picker, no DevTools paste.
+    """
+    default_name = os.environ.get("USER") or os.environ.get("USERNAME") or ""
+    default_workdir = str(Path.home() / "Documents" / "Maverick")
+
+    # The first invoke carries no answer; consume it and ask Q1.
+    _recv()
+
+    # Q1: name
+    _send(_step(
+        "name",
+        "What should we call you?",
+        [],
+        kind="text",
+    ))
+    user_name = _recv().strip() or default_name or "you"
+
+    # Q2: API key (sign-in). The UI shows the console.anthropic.com link
+    # and a masked field. Blank == skip (config saved without a key).
+    _send(_step(
+        "api_key",
+        "Paste your Anthropic API key. Get one at "
+        "https://console.anthropic.com/settings/keys (or leave blank to skip).",
+        [],
+        kind="secret",
+    ))
+    raw_key = _recv().strip()
+    keys: dict[str, str] = {"ANTHROPIC_API_KEY": raw_key} if raw_key else {}
+
+    # Q3: working directory
+    _send(_step(
+        "workdir",
+        "Where can Maverick work? (a folder it can create files in)",
+        [],
+        kind="text",
+    ))
+    workdir = _recv().strip() or default_workdir
+
+    # Q4: budget
+    _send(_step(
+        "budget",
+        "Stop after spending how much per task?",
+        ["$1", "$5", "$20"],
+    ))
+    budget_ans = _recv().strip() or "$5"
+    try:
+        dollars = float(budget_ans.lstrip("$"))
+    except ValueError:
+        dollars = 5.0
+    budget = {
+        "max_dollars": dollars,
+        "max_wall_seconds": 600.0,
+        "max_tool_calls": 100,
+    }
+
+    write_consumer_config(
+        user_name=user_name, keys=keys, workdir=workdir, budget=budget,
+    )
+
+    if keys:
+        msg = f"Setup complete, {user_name}. Maverick is ready."
+    else:
+        msg = (
+            f"Setup saved, {user_name}. Add an API key later from Settings "
+            "or by running 'maverick init' again."
+        )
+    _send(_step("__done__", msg, []))
+
+
+if __name__ == "__main__":
+    try:
+        run()
+    except Exception as e:
+        _send({"id": "__error__", "question": str(e), "choices": [], "kind": "error"})
+        sys.exit(1)

maverick_installer-0.1.2/maverick_installer/main.py

@@ -0,0 +1,36 @@
+"""Standalone entry point for the installer.
+
+Installed as the ``maverick-init`` console script. Also reachable via
+``maverick init`` when the core CLI is installed.
+"""
+from __future__ import annotations
+
+import argparse
+import sys
+
+from .wizard import run
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(
+        prog="maverick-init",
+        description="Interactive setup wizard for Maverick.",
+    )
+    parser.add_argument(
+        "--fast", action="store_true",
+        help="Skip every prompt; use recommended defaults.",
+    )
+    parser.add_argument(
+        "--resume", action="store_true",
+        help="Resume from the last unanswered wizard question.",
+    )
+    args = parser.parse_args(argv)
+    try:
+        return run(fast=args.fast, resume=args.resume)
+    except (KeyboardInterrupt, EOFError):
+        print("\nAborted. Re-run `maverick init` any time.")
+        return 130
+
+
+if __name__ == "__main__":
+    sys.exit(main())

maverick_installer-0.1.2/maverick_installer/models.py

@@ -0,0 +1,183 @@
+"""Curated catalog of supported models per provider.
+
+Updated whenever providers ship new models. Each entry has an id, a
+notes string the wizard shows, and a status marker.
+
+All five providers are now wired up. Picking any of them in the wizard
+generates a config that the agent kernel actually dispatches to via
+the multi-provider LLM facade.
+"""
+
+ROLES: list[tuple[str, str]] = [
+    ("orchestrator",    "Plans, decomposes, verifies. Use a large model here."),
+    ("researcher",      "Searches and gathers information."),
+    ("coder",           "Writes and tests code."),
+    ("writer",          "Drafts longer-form prose."),
+    ("analyst",         "Synthesises findings; reasoning-heavy."),
+    ("revisor",         "Second-pass review when verification fails."),
+    ("verifier",        "Independent final-answer check."),
+    ("summarizer",      "Distillation. A small model is enough."),
+    ("skill_distiller", "Turns trajectories into reusable skills."),
+]
+
+
+PROVIDERS: dict[str, dict] = {
+    "anthropic": {
+        "status": "ready",
+        "label": "Anthropic Claude",
+        "env": "ANTHROPIC_API_KEY",
+        "models": [
+            {"id": "claude-opus-4-7",   "notes": "Smartest, slowest, most expensive. Best for orchestrator/revisor."},
+            {"id": "claude-sonnet-4-6", "notes": "Balanced. Recommended workhorse."},
+            {"id": "claude-haiku-4-5",  "notes": "Fast and cheap. Good for summarizer."},
+        ],
+    },
+    "openai": {
+        "status": "ready",
+        "label": "OpenAI (ChatGPT / GPT)",
+        "env": "OPENAI_API_KEY",
+        "models": [
+            {"id": "gpt-5.5",       "notes": "Most capable. Tool-use and long reasoning."},
+            {"id": "gpt-5.4",       "notes": "Balanced workhorse."},
+            {"id": "gpt-5.4-mini",  "notes": "Cheaper, fast."},
+            {"id": "gpt-5.4-nano",  "notes": "Tiny, very cheap. Good for summarizer."},
+        ],
+    },
+    "moonshot": {
+        "status": "ready",
+        "label": "Moonshot / Kimi",
+        "env": "MOONSHOT_API_KEY",
+        "models": [
+            {"id": "kimi-k2",          "notes": "Latest Kimi. Strong agentic/code performance."},
+            {"id": "kimi-k1.5",        "notes": "Cheaper, still solid."},
+            {"id": "moonshot-v1-128k", "notes": "128k context window."},
+        ],
+    },
+    "deepseek": {
+        "status": "ready",
+        "label": "DeepSeek",
+        "env": "DEEPSEEK_API_KEY",
+        "models": [
+            {"id": "deepseek-chat",     "notes": "V3.2 chat. Cheap, capable workhorse."},
+            {"id": "deepseek-reasoner", "notes": "R1-line reasoning. Slower, deeper."},
+            {"id": "deepseek-v4-flash", "notes": "Very cheap. Good for summarizer."},
+        ],
+    },
+    "xai": {
+        "status": "ready",
+        "label": "xAI Grok",
+        "env": "XAI_API_KEY",
+        "models": [
+            {"id": "grok-4-latest",  "notes": "Flagship. Reasoning + tools."},
+            {"id": "grok-4-mini",    "notes": "Cheaper sibling."},
+            {"id": "grok-code-fast", "notes": "Code-tuned, low latency."},
+        ],
+    },
+    "gemini": {
+        "status": "ready",
+        "label": "Google Gemini",
+        "env": "GEMINI_API_KEY",
+        "models": [
+            {"id": "gemini-3-pro",   "notes": "Long context, smart."},
+            {"id": "gemini-3-flash", "notes": "Fast and cheap."},
+        ],
+    },
+    "openrouter": {
+        "status": "ready",
+        "label": "OpenRouter (200+ models via one API)",
+        "env": "OPENROUTER_API_KEY",
+        "models": [
+            {"id": "auto",                       "notes": "OpenRouter picks for you."},
+            {"id": "meta-llama/llama-3.3-70b",  "notes": "Open weight, strong general."},
+            {"id": "google/gemini-pro-1.5",     "notes": "Long context."},
+            {"id": "deepseek/deepseek-r1",      "notes": "Strong reasoning, cheap."},
+        ],
+    },
+    "ollama": {
+        "status": "ready",
+        "label": "Ollama (local, free, private)",
+        "env": None,
+        "models": [
+            {"id": "llama3.3:70b",         "notes": "Local, free, requires beefy machine."},
+            {"id": "qwen2.5-coder:32b",    "notes": "Local, code-focused."},
+            {"id": "phi3:14b",             "notes": "Local, small, fast."},
+        ],
+    },
+    "tgi": {
+        "status": "ready",
+        "label": "HuggingFace TGI (self-hosted inference)",
+        "env": None,
+        "models": [
+            {"id": "tgi",                  "notes": "Whatever model your TGI server serves; URL via TGI_BASE_URL env."},
+        ],
+    },
+    "chatgpt-session": {
+        "status": "ready",
+        "label": "ChatGPT browser session (use your Plus subscription, no API key)",
+        "env": None,
+        "session": True,
+        "tool_support": False,
+        "models": [
+            {"id": "gpt-4o",      "notes": "Free for Plus subscribers. Best for summarizer/writer/analyst."},
+            {"id": "gpt-4o-mini", "notes": "Free tier model. Use for cheap roles."},
+        ],
+    },
+    "claude-session": {
+        "status": "ready",
+        "label": "Claude.ai browser session (use your Pro subscription, no API key)",
+        "env": None,
+        "session": True,
+        "tool_support": False,
+        "models": [
+            {"id": "claude-sonnet-4-6", "notes": "Pro default. Best for summarizer/writer/analyst."},
+            {"id": "claude-haiku-4-5",  "notes": "Faster, lower quota cost."},
+        ],
+    },
+    "kimi-session": {
+        "status": "ready",
+        "label": "Kimi browser session (use your kimi.com subscription)",
+        "env": None,
+        "session": True,
+        "tool_support": False,
+        "models": [
+            {"id": "kimi-k2",   "notes": "Latest Kimi. Strong agentic / code."},
+            {"id": "kimi-k1.5", "notes": "Cheaper, lighter quota cost."},
+        ],
+    },
+    "grok-session": {
+        "status": "ready",
+        "label": "Grok via x.com browser session (requires X Premium)",
+        "env": None,
+        "session": True,
+        "tool_support": False,
+        "models": [
+            {"id": "grok-4-latest", "notes": "Flagship. Reasoning + tools."},
+            {"id": "grok-4-mini",   "notes": "Cheaper sibling."},
+        ],
+    },
+    "gemini-session": {
+        "status": "ready",
+        "label": "Gemini browser session (gemini.google.com Advanced)",
+        "env": None,
+        "session": True,
+        "tool_support": False,
+        "models": [
+            {"id": "gemini-3-pro",   "notes": "Long context, smart."},
+            {"id": "gemini-3-flash", "notes": "Fast and cheap."},
+        ],
+    },
+}
+
+
+def default_for_role(role: str) -> str:
+    return {
+        "orchestrator":    "anthropic:claude-opus-4-7",
+        "researcher":      "anthropic:claude-sonnet-4-6",
+        "coder":           "anthropic:claude-sonnet-4-6",
+        "writer":          "anthropic:claude-sonnet-4-6",
+        "analyst":         "anthropic:claude-sonnet-4-6",
+        "revisor":         "anthropic:claude-opus-4-7",
+        "verifier":        "anthropic:claude-sonnet-4-6",
+        "summarizer":      "anthropic:claude-haiku-4-5",
+        "skill_distiller": "anthropic:claude-sonnet-4-6",
+    }[role]