gulutux 0.2.4__tar.gz

gulutux-0.2.4/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: gulutux
+Version: 0.2.4
+Summary: Multi-provider agentic coding CLI — swap the brain (Nebius Token Factory, Cloudflare, Google, any OpenAI-compatible), keep the fox.
+License: MIT
+Project-URL: Homepage, https://github.com/autokeren/gulutux
+Project-URL: Repository, https://github.com/autokeren/gulutux
+Keywords: ai,agent,cli,coding,nemotron,nebius,llm
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# 🦊 gulutux
+
+**Multi-provider agentic coding CLI.** Swap the brain — Nebius Token Factory,
+Cloudflare Workers AI, Google, or any OpenAI-compatible endpoint — keep the fox.
+
+> Named after my childhood nickname. Gulutux writes the code, its ghost agents
+> run in parallel, and Ghostfox — the stealth browser — sees the web.
+
+## What it is
+
+gulutux is a terminal-native agentic coding assistant built in Go:
+
+- **Multi-provider model layer** — one agent loop, any brain: Nebius Token
+  Factory (NVIDIA Nemotron), Cloudflare Workers AI, Google AI Studio, OpenAI,
+  or any OpenAI-compatible endpoint (Ollama, vLLM, proxies).
+- **Token Factory Sandboxes execution** — commands run in ephemeral Nebius
+  microVM containers (`sandbox` tool: one-shot runs or named sessions), with
+  automatic sandbox→local fallback.
+- **Cost-aware routing** — per-model pricing table, live token/USD metering
+  from real API usage, and a session budget guard that downshifts to a fast
+  model when the budget is reached.
+- **Ghost agents** — spawn parallel sub-agents (`spawn_agent`) with
+  capability-scoped tool allowlists and structured result mailboxes.
+- **Evidence-led proofs** — acceptance criteria, recorded verification, and a
+  `SHIP / BLOCKED / NEEDS_HUMAN_REVIEW` verdict gated by human approval.
+  Deploy tools are blocked at the registry level until a proof is approved for
+  the exact git commit.
+- **Real browsers at its side** — a generic Chrome (CDP) layer and **Ghostfox**,
+  a stealth browser driven through its MCP server: navigate, snapshot, click,
+  type, screenshot with anti-detection identities.
+- **Tavily web search** built in for grounded, real-time research.
+- **Checkpoints (time travel)**, per-project persistent memory, SQLite kanban,
+  and a vibe-security guard over shell/file tools.
+
+## Build & run
+
+Requires Go 1.22+.
+
+```bash
+make build        # produces ./gx
+./gx              # interactive TUI
+./gx "explain this repo" --task    # one-shot task
+./gx --proof replay examples/proof-demo/proof-run.json   # replay a proof, zero API keys
+```
+
+Configure providers in `~/.config/gulutux/config.yaml` (see
+`config.example.yaml`). Environment: `GULUTUX_*` (e.g. `GULUTUX_API_KEY`).
+
+**Live demo:** https://gulutux.autokeren.com — this landing page was built,
+rendered, and proof-verified **by the agent itself** in the demo video.
+
+## Status
+
+**v0.1.x** — foundation + Nebius stack verified live. All 24 Go packages pass
+vet + tests. Verified end-to-end with NVIDIA Nemotron on Nebius Token Factory:
+
+- agent thinking with `nvidia/nemotron-3-super-120b-a12b` (with automatic
+  downshift to `Nemotron-3_5-Lightning` when a session budget is exceeded)
+- Token Factory Sandboxes client (Contree API): spawn instances, subprocesses
+  inside running VMs, one-shot runs, named sessions
+- live dogfood run: the agent researched landing-page design via Tavily,
+  wrote a page, rendered it in the Ghostfox stealth browser, and issued a
+  `SHIP` proof — 13 turns, $0.08 of model spend
+
+## Origin & license
+
+MIT © 2026 Ajat Sudrajat.
+
+gulutux is the successor of my prior open-source project
+[autokeren](https://github.com/autokeren/autokeren) (MIT) — a Cloudflare-first
+agentic CLI. The Go engine core, tool suite, ghost sub-agent manager, and
+evidence-led proof system were carried over and are being significantly
+extended for this project: a rewritten multi-provider architecture, native
+Nebius Token Factory integration (inference + sandboxes), Ghostfox browser
+integration, and a structured agent state machine. The prior project is
+disclosed here explicitly, in the spirit of honest open source.
+
+Built during the **Nebius x NVIDIA Global AI Hackathon** — running on
+Nebius AI Cloud, thinking with NVIDIA Nemotron.

gulutux-0.2.4/README.md

@@ -0,0 +1,79 @@
+# 🦊 gulutux
+
+**Multi-provider agentic coding CLI.** Swap the brain — Nebius Token Factory,
+Cloudflare Workers AI, Google, or any OpenAI-compatible endpoint — keep the fox.
+
+> Named after my childhood nickname. Gulutux writes the code, its ghost agents
+> run in parallel, and Ghostfox — the stealth browser — sees the web.
+
+## What it is
+
+gulutux is a terminal-native agentic coding assistant built in Go:
+
+- **Multi-provider model layer** — one agent loop, any brain: Nebius Token
+  Factory (NVIDIA Nemotron), Cloudflare Workers AI, Google AI Studio, OpenAI,
+  or any OpenAI-compatible endpoint (Ollama, vLLM, proxies).
+- **Token Factory Sandboxes execution** — commands run in ephemeral Nebius
+  microVM containers (`sandbox` tool: one-shot runs or named sessions), with
+  automatic sandbox→local fallback.
+- **Cost-aware routing** — per-model pricing table, live token/USD metering
+  from real API usage, and a session budget guard that downshifts to a fast
+  model when the budget is reached.
+- **Ghost agents** — spawn parallel sub-agents (`spawn_agent`) with
+  capability-scoped tool allowlists and structured result mailboxes.
+- **Evidence-led proofs** — acceptance criteria, recorded verification, and a
+  `SHIP / BLOCKED / NEEDS_HUMAN_REVIEW` verdict gated by human approval.
+  Deploy tools are blocked at the registry level until a proof is approved for
+  the exact git commit.
+- **Real browsers at its side** — a generic Chrome (CDP) layer and **Ghostfox**,
+  a stealth browser driven through its MCP server: navigate, snapshot, click,
+  type, screenshot with anti-detection identities.
+- **Tavily web search** built in for grounded, real-time research.
+- **Checkpoints (time travel)**, per-project persistent memory, SQLite kanban,
+  and a vibe-security guard over shell/file tools.
+
+## Build & run
+
+Requires Go 1.22+.
+
+```bash
+make build        # produces ./gx
+./gx              # interactive TUI
+./gx "explain this repo" --task    # one-shot task
+./gx --proof replay examples/proof-demo/proof-run.json   # replay a proof, zero API keys
+```
+
+Configure providers in `~/.config/gulutux/config.yaml` (see
+`config.example.yaml`). Environment: `GULUTUX_*` (e.g. `GULUTUX_API_KEY`).
+
+**Live demo:** https://gulutux.autokeren.com — this landing page was built,
+rendered, and proof-verified **by the agent itself** in the demo video.
+
+## Status
+
+**v0.1.x** — foundation + Nebius stack verified live. All 24 Go packages pass
+vet + tests. Verified end-to-end with NVIDIA Nemotron on Nebius Token Factory:
+
+- agent thinking with `nvidia/nemotron-3-super-120b-a12b` (with automatic
+  downshift to `Nemotron-3_5-Lightning` when a session budget is exceeded)
+- Token Factory Sandboxes client (Contree API): spawn instances, subprocesses
+  inside running VMs, one-shot runs, named sessions
+- live dogfood run: the agent researched landing-page design via Tavily,
+  wrote a page, rendered it in the Ghostfox stealth browser, and issued a
+  `SHIP` proof — 13 turns, $0.08 of model spend
+
+## Origin & license
+
+MIT © 2026 Ajat Sudrajat.
+
+gulutux is the successor of my prior open-source project
+[autokeren](https://github.com/autokeren/autokeren) (MIT) — a Cloudflare-first
+agentic CLI. The Go engine core, tool suite, ghost sub-agent manager, and
+evidence-led proof system were carried over and are being significantly
+extended for this project: a rewritten multi-provider architecture, native
+Nebius Token Factory integration (inference + sandboxes), Ghostfox browser
+integration, and a structured agent state machine. The prior project is
+disclosed here explicitly, in the spirit of honest open source.
+
+Built during the **Nebius x NVIDIA Global AI Hackathon** — running on
+Nebius AI Cloud, thinking with NVIDIA Nemotron.

gulutux-0.2.4/gulutux/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.4"

gulutux-0.2.4/gulutux/launcher.py

@@ -0,0 +1,57 @@
+import os
+import platform
+import stat
+import sys
+import urllib.request
+from pathlib import Path
+
+RELEASE = "v0.2.4"
+BASE = f"https://github.com/autokeren/gulutux/releases/download/{RELEASE}"
+
+_version = f"gulutux {__import__('gulutux').__version__}"
+
+
+def _asset_name() -> str:
+    machine = platform.machine().lower()
+    arch = {"x86_64": "amd64", "amd64": "amd64", "aarch64": "arm64", "arm64": "arm64"}.get(machine)
+    if arch is None:
+        raise SystemExit(f"gulutux: unsupported architecture: {machine}")
+    if sys.platform.startswith("darwin"):
+        return f"gx-darwin-{arch}"
+    if sys.platform.startswith("win"):
+        return f"gx-windows-{arch}.exe"
+    return f"gx-linux-{arch}"
+
+
+def _binary_path() -> Path:
+    home = Path(os.environ.get("XDG_DATA_HOME", Path.home() / ".local" / "share"))
+    return home / "gulutux" / "gx" / RELEASE
+
+
+def _ensure_binary() -> Path:
+    override = os.environ.get("GULUTUX_BIN_PATH")
+    if override:
+        return Path(override)
+    target = _binary_path()
+    if target.exists():
+        return target
+    name = _asset_name()
+    target.parent.mkdir(parents=True, exist_ok=True)
+    print(f"gulutux: downloading {name} from GitHub release {RELEASE}...", file=sys.stderr)
+    with urllib.request.urlopen(f"{BASE}/{name}", timeout=120) as resp:
+        data = resp.read()
+    target.write_bytes(data)
+    target.chmod(target.stat().st_mode | stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH)
+    print(f"gulutux: installed {target}", file=sys.stderr)
+    return target
+
+
+def main() -> None:
+    binary = _ensure_binary()
+    if not binary.exists():
+        raise SystemExit(f"gulutux: binary not found at {binary}")
+    os.execv(str(binary), [str(binary), *sys.argv[1:]])
+
+
+if __name__ == "__main__":
+    main()

gulutux-0.2.4/gulutux.egg-info/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: gulutux
+Version: 0.2.4
+Summary: Multi-provider agentic coding CLI — swap the brain (Nebius Token Factory, Cloudflare, Google, any OpenAI-compatible), keep the fox.
+License: MIT
+Project-URL: Homepage, https://github.com/autokeren/gulutux
+Project-URL: Repository, https://github.com/autokeren/gulutux
+Keywords: ai,agent,cli,coding,nemotron,nebius,llm
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# 🦊 gulutux
+
+**Multi-provider agentic coding CLI.** Swap the brain — Nebius Token Factory,
+Cloudflare Workers AI, Google, or any OpenAI-compatible endpoint — keep the fox.
+
+> Named after my childhood nickname. Gulutux writes the code, its ghost agents
+> run in parallel, and Ghostfox — the stealth browser — sees the web.
+
+## What it is
+
+gulutux is a terminal-native agentic coding assistant built in Go:
+
+- **Multi-provider model layer** — one agent loop, any brain: Nebius Token
+  Factory (NVIDIA Nemotron), Cloudflare Workers AI, Google AI Studio, OpenAI,
+  or any OpenAI-compatible endpoint (Ollama, vLLM, proxies).
+- **Token Factory Sandboxes execution** — commands run in ephemeral Nebius
+  microVM containers (`sandbox` tool: one-shot runs or named sessions), with
+  automatic sandbox→local fallback.
+- **Cost-aware routing** — per-model pricing table, live token/USD metering
+  from real API usage, and a session budget guard that downshifts to a fast
+  model when the budget is reached.
+- **Ghost agents** — spawn parallel sub-agents (`spawn_agent`) with
+  capability-scoped tool allowlists and structured result mailboxes.
+- **Evidence-led proofs** — acceptance criteria, recorded verification, and a
+  `SHIP / BLOCKED / NEEDS_HUMAN_REVIEW` verdict gated by human approval.
+  Deploy tools are blocked at the registry level until a proof is approved for
+  the exact git commit.
+- **Real browsers at its side** — a generic Chrome (CDP) layer and **Ghostfox**,
+  a stealth browser driven through its MCP server: navigate, snapshot, click,
+  type, screenshot with anti-detection identities.
+- **Tavily web search** built in for grounded, real-time research.
+- **Checkpoints (time travel)**, per-project persistent memory, SQLite kanban,
+  and a vibe-security guard over shell/file tools.
+
+## Build & run
+
+Requires Go 1.22+.
+
+```bash
+make build        # produces ./gx
+./gx              # interactive TUI
+./gx "explain this repo" --task    # one-shot task
+./gx --proof replay examples/proof-demo/proof-run.json   # replay a proof, zero API keys
+```
+
+Configure providers in `~/.config/gulutux/config.yaml` (see
+`config.example.yaml`). Environment: `GULUTUX_*` (e.g. `GULUTUX_API_KEY`).
+
+**Live demo:** https://gulutux.autokeren.com — this landing page was built,
+rendered, and proof-verified **by the agent itself** in the demo video.
+
+## Status
+
+**v0.1.x** — foundation + Nebius stack verified live. All 24 Go packages pass
+vet + tests. Verified end-to-end with NVIDIA Nemotron on Nebius Token Factory:
+
+- agent thinking with `nvidia/nemotron-3-super-120b-a12b` (with automatic
+  downshift to `Nemotron-3_5-Lightning` when a session budget is exceeded)
+- Token Factory Sandboxes client (Contree API): spawn instances, subprocesses
+  inside running VMs, one-shot runs, named sessions
+- live dogfood run: the agent researched landing-page design via Tavily,
+  wrote a page, rendered it in the Ghostfox stealth browser, and issued a
+  `SHIP` proof — 13 turns, $0.08 of model spend
+
+## Origin & license
+
+MIT © 2026 Ajat Sudrajat.
+
+gulutux is the successor of my prior open-source project
+[autokeren](https://github.com/autokeren/autokeren) (MIT) — a Cloudflare-first
+agentic CLI. The Go engine core, tool suite, ghost sub-agent manager, and
+evidence-led proof system were carried over and are being significantly
+extended for this project: a rewritten multi-provider architecture, native
+Nebius Token Factory integration (inference + sandboxes), Ghostfox browser
+integration, and a structured agent state machine. The prior project is
+disclosed here explicitly, in the spirit of honest open source.
+
+Built during the **Nebius x NVIDIA Global AI Hackathon** — running on
+Nebius AI Cloud, thinking with NVIDIA Nemotron.

gulutux-0.2.4/gulutux.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+gulutux/__init__.py
+gulutux/launcher.py
+gulutux.egg-info/PKG-INFO
+gulutux.egg-info/SOURCES.txt
+gulutux.egg-info/dependency_links.txt
+gulutux.egg-info/entry_points.txt
+gulutux.egg-info/top_level.txt

gulutux-0.2.4/gulutux.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

gulutux-0.2.4/gulutux.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+gulutux = gulutux.launcher:main
+gx = gulutux.launcher:main

gulutux-0.2.4/gulutux.egg-info/top_level.txt

@@ -0,0 +1 @@
+gulutux

gulutux-0.2.4/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "gulutux"
+version = "0.2.4"
+description = "Multi-provider agentic coding CLI — swap the brain (Nebius Token Factory, Cloudflare, Google, any OpenAI-compatible), keep the fox."
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.8"
+keywords = ["ai", "agent", "cli", "coding", "nemotron", "nebius", "llm"]
+
+[project.urls]
+Homepage = "https://github.com/autokeren/gulutux"
+Repository = "https://github.com/autokeren/gulutux"
+
+[project.scripts]
+gulutux = "gulutux.launcher:main"
+gx = "gulutux.launcher:main"
+
+[tool.setuptools]
+packages = ["gulutux"]

gulutux-0.2.4/setup.cfg

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