Skip to content

Personal AI, On Personal Devices

Python

feat(cli): arc-reactor startup banner for init/serve/ask (#397)

Robby Manihani71c5b2bce12c
diff --git a/src/openjarvis/cli/_banner.py b/src/openjarvis/cli/_banner.py
new file mode 100644
index 00000000..f3952caa
--- /dev/null
+++ b/src/openjarvis/cli/_banner.py
@@ -0,0 +1,41 @@
+"""Startup banner — arc-reactor logo + OpenJarvis wordmark."""
+
+# ruff: noqa: E501 — Rich markup tags inflate source-line length; the rendered
+# banner stays under 80 displayed columns.
+
+from __future__ import annotations
+
+# Reactor on the left (5 lines, ~12 cols) + small ASCII wordmark on the right.
+# Last line carries the tagline so the whole block stays under 8 lines / 80 cols.
+_BANNER_LINES = (
+ r" [blue]╭─────╮[/blue] [bold bright_blue] ___ _ _ [/]",
+ r" [blue]╱[/blue] [bright_blue]╭───╮[/bright_blue] [blue]╲[/blue] [bold bright_blue]/ _ \ _ __ ___ _ _ | | __ _ _ ___ _(_)___[/]",
+ r" [blue]│[/blue] [bright_blue]│[/bright_blue] [bold bright_white]◉[/] [bright_blue]│[/bright_blue] [blue]│[/blue] [bold bright_blue]| | | | '_ \/ -_) ' \ | |/ _` | '_\ V /| (_-<[/]",
+ r" [blue]╲[/blue] [bright_blue]╰───╯[/bright_blue] [blue]╱[/blue] [bold bright_blue]\___/| .__/\___|_||_||_|\__,_|_| \_/ |_/__/[/]",
+ r" [blue]╰─────╯[/blue] [dim]|_|[/dim] [cyan]Private AI on your machine[/cyan]",
+)
+
+_PLAIN_BANNER = (
+ r" ╭─────╮ ___ _ _ ",
+ r" ╱ ╭───╮ ╲ / _ \ _ __ ___ _ _ | | __ _ _ ___ _(_)___ ",
+ r" │ │ ◉ │ │ | | | | '_ \/ -_) ' \ | |/ _` | '_\ V /| (_-< ",
+ r" ╲ ╰───╯ ╱ \___/| .__/\___|_||_||_|\__,_|_| \_/ |_/__/ ",
+ r" ╰─────╯ |_| Private AI on your machine ",
+)
+
+
+def print_banner(quiet: bool = False) -> None:
+ """Print the OpenJarvis startup banner. No-op when quiet."""
+ if quiet:
+ return
+ try:
+ from rich.console import Console
+
+ console = Console()
+ for line in _BANNER_LINES:
+ console.print(line, highlight=False)
+ console.print()
+ except ImportError:
+ for line in _PLAIN_BANNER:
+ print(line)
+ print()
diff --git a/src/openjarvis/cli/ask.py b/src/openjarvis/cli/ask.py
index 06782b8a..fa61d39c 100644
--- a/src/openjarvis/cli/ask.py
+++ b/src/openjarvis/cli/ask.py
@@ -11,6 +11,7 @@ import click
from rich.console import Console
from rich.table import Table
+from openjarvis.cli._banner import print_banner
from openjarvis.cli._tool_names import resolve_tool_names
from openjarvis.cli.hints import hint_no_engine
from openjarvis.core.config import load_config
@@ -587,7 +588,9 @@ def _print_profile(
"(default: ~/.openjarvis/knowledge.db)."
),
)
def ask(
+ ctx: click.Context,
query: tuple[str, ...],
model_name: str | None,
engine_key: str | None,
@@ -603,6 +606,8 @@ def ask(
knowledge_db: str | None,
) -> None:
"""Ask Jarvis a question."""
+ quiet = (ctx.obj or {}).get("quiet", False) or output_json
+ print_banner(quiet=quiet)
console = Console(stderr=True)
query_text = " ".join(query)
diff --git a/src/openjarvis/cli/init_cmd.py b/src/openjarvis/cli/init_cmd.py
index e69baf09..869c2746 100644
--- a/src/openjarvis/cli/init_cmd.py
+++ b/src/openjarvis/cli/init_cmd.py
@@ -11,6 +11,7 @@ from rich.console import Console
from rich.markup import escape
from rich.panel import Panel
+from openjarvis.cli._banner import print_banner
from openjarvis.cli._bootstrap import detect_cloud_keys
from openjarvis.cli.model import find_model_spec, hf_download, ollama_pull
from openjarvis.cli.scan_cmd import PrivacyScanner
@@ -290,7 +291,9 @@ def _do_download(engine: str, model: str, spec, console: Console) -> None:
hidden=True,
help="Run init non-interactively; called by the bare-jarvis first-run guard.",
)
def init(
+ ctx: click.Context,
force: bool,
config: Optional[Path],
full_config: bool = False,
@@ -303,6 +306,7 @@ def init(
from_bare_jarvis: bool = False,
) -> None:
"""Detect hardware and generate ~/.openjarvis/config.toml."""
+ print_banner(quiet=(ctx.obj or {}).get("quiet", False))
console = Console()
# Cloud auto-detect — inform user if a key is in env.
diff --git a/src/openjarvis/cli/serve.py b/src/openjarvis/cli/serve.py
index 3bda0864..ef69c4ec 100644
--- a/src/openjarvis/cli/serve.py
+++ b/src/openjarvis/cli/serve.py
@@ -8,6 +8,7 @@ import sys
import click
from rich.console import Console
+from openjarvis.cli._banner import print_banner
from openjarvis.core.config import load_config
from openjarvis.core.events import EventBus
from openjarvis.engine import (
@@ -40,7 +41,9 @@ logger = logging.getLogger(__name__)
default=None,
help="Agent for non-streaming requests (simple, orchestrator, react, openhands).",
)
def serve(
+ ctx: click.Context,
host: str | None,
port: int | None,
engine_key: str | None,
@@ -48,6 +51,7 @@ def serve(
agent_name: str | None,
) -> None:
"""Start the OpenAI-compatible API server."""
+ print_banner(quiet=(ctx.obj or {}).get("quiet", False))
console = Console(stderr=True)
# Check for server dependencies