Skip to main content

🦊 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+.

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 (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.

Metadata

Release files for gulutux 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gulutux 0.4.0
File Size Uploaded Provenance
gulutux-0.4.0.tar.gz 4.1 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for gulutux 0.4.0
File Interpreter ABI Platform
gulutux-0.4.0-py3-none-any.whl Python 3 none any Details

Total release size: 8.6 kB

Release files / gulutux-0.4.0.tar.gz

Download URL gulutux-0.4.0.tar.gz
Size 4.1 kB
Tags Source
SHA-256 checksum
How to use checksums
7dcdcabbab8f665063bbfbfb524dd4affd84f56460f67536b8b3a2179d947f8d
BLAKE2b-256 checksum
How to use checksums
29668bf80854c57109756c0f094ab27f0998150b6d46c510c71fc87e891b495b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / gulutux-0.4.0-py3-none-any.whl

Download URL gulutux-0.4.0-py3-none-any.whl
Size 4.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
23facec1832d199c1ba96458c59eaa815ea1d057f4b83d37f2bce5f4e62e7f09
BLAKE2b-256 checksum
How to use checksums
b489cdb0636c3124be957e44074c13a97af8098947126ee9c03d23e51b961fea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for gulutux 0.4.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release

0.4.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page