diff --git a/.gitignore b/.gitignore index 108c5c3..925eb73 100644 --- a/.gitignore +++ b/.gitignore @@ -21,6 +21,10 @@ docker/.odek/* sec_findings.md +# Local commercial brief (not product docs) +PITCH.html +PITCH.pdf + # Docs-audit working set — local only docs_findings.md SUB_AGENTS_IMPROVEMENTS.md diff --git a/AGENTS.md b/AGENTS.md index 5c01a16..0a3c4cc 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -9,7 +9,7 @@ It provides context about the project's architecture, conventions, and how to up - **Package:** `odek` (Go module: `github.com/BackendStack21/odek`) - **What it is:** Minimal Go autonomous agent runtime — ReAct (Reasoning + Acting) loop with zero frameworks (stdlib + a few focused packages). -- **Binary:** `odek` — single static binary, ~11 MB, instant startup. +- **Binary:** `odek` — single static binary, <15 MB, instant startup. - **Config:** Five-layer priority: `~/.odek/secrets.env` → `~/.odek/config.json` → `./odek.json` → `ODEK_*` env vars → CLI flags. - **Extension contract:** `odek-extension/v1` (docs/EXTENSIONS.md) — MCP server limits, artifact refs, runtime events, external session refs, execution budgets. - **Releases:** tag-driven (`git tag vX.Y.Z && git push --tags` builds binaries + release). See [GitHub Releases](https://github.com/BackendStack21/odek/releases). diff --git a/GETTING_STARTED.md b/GETTING_STARTED.md index 483073b..773f5c9 100644 --- a/GETTING_STARTED.md +++ b/GETTING_STARTED.md @@ -2,7 +2,7 @@ Install **odek** (the agent engine), configure it with a **GLM 5.3 Flash** subscription from **z.ai**, and — optionally — add **bodek**, a polished terminal UI on top. -odek is a single static Go binary (~11 MB, instant startup). No Python, no Node, no framework — one binary and an API key is the whole install. +odek is a single static Go binary (<15 MB, instant startup). No Python, no Node, no framework — one binary and an API key is the whole install. --- diff --git a/README.md b/README.md index 35068b0..fc222fb 100644 --- a/README.md +++ b/README.md @@ -32,7 +32,7 @@ odek is not a framework. It's a **runtime** — the smallest possible surface ar | | odek | Python agents (LangChain, CrewAI, etc.) | |---|---|---| | Dependencies | **6.** 3× 21no.de, 3× golang.org/x | 200+ packages | -| Binary size | ~11 MB static | 50-200 MB with venv | +| Binary size | <15 MB static | 50-200 MB with venv | | Startup | **Instant** | 2-10s (Python imports) | | Sandbox | **Default-on** Docker sandbox (`--no-sandbox` to opt out) | Requires manual Docker setup | | Tool interface | One interface, one method | Class hierarchies + decorators | diff --git a/cmd/odek/telegram.go b/cmd/odek/telegram.go index 0fdf470..c57e025 100644 --- a/cmd/odek/telegram.go +++ b/cmd/odek/telegram.go @@ -435,7 +435,7 @@ func telegramCmd(args []string) error { systemMessage += "- odek website: https://odek.21no.de\n" systemMessage += "- Built by: 21no.de (https://21no.de)\n" systemMessage += "- Binary name: odek\n" - systemMessage += "- Language: Go, minimal dependencies, ~11 MB binary\n" + systemMessage += "- Language: Go, minimal dependencies, <15 MB binary\n" systemMessage += "\n" systemMessage += "File attachment:\n" systemMessage += "- You CAN send files (zip, pdf, images, csv, etc.) in BOTH intermediate replies\n" diff --git a/docs/CHEATSHEET.md b/docs/CHEATSHEET.md index 442e58c..7ca8786 100644 --- a/docs/CHEATSHEET.md +++ b/docs/CHEATSHEET.md @@ -361,7 +361,7 @@ odek mcp --sandbox ## Key Design Properties - **Minimal Go dependencies** — all minimal-dependency Go packages from 21no.de -- **~11 MB static binary** +- **<15 MB static binary** - **One loop, one interface** — tool implementers write `func Call(args string) (string, error)` - **File-based config** — no YAML, no DSL, no schema generation - **Sandbox on by default** (CLI) with loud unsandboxed fallback when Docker is missing — no container runtime *required*, isolation unless you opt out diff --git a/docs/index.html b/docs/index.html index 105bced..0dd7f10 100644 --- a/docs/index.html +++ b/docs/index.html @@ -6,7 +6,7 @@ odek · Move fast. Stay in control. - + @@ -14,19 +14,19 @@ - + - + - + - + @@ -41,7 +41,7 @@ "name": "odek", "applicationCategory": "DeveloperApplication", "operatingSystem": "Linux, macOS", - "description": "A ~11 MB static Go binary that runs an autonomous ReAct agent loop. Zero frameworks. Provider-agnostic. Sandbox on by default.", + "description": "A <15 MB static Go binary that runs an autonomous ReAct agent loop. Zero frameworks. Provider-agnostic. Sandbox on by default.", "url": "https://odek.21no.de", "downloadUrl": "https://github.com/BackendStack21/odek/releases", "license": "https://github.com/BackendStack21/odek/blob/main/LICENSE", @@ -61,7 +61,7 @@ "name": "What is odek?", "acceptedAnswer": { "@type": "Answer", - "text": "odek is a ~11 MB static Go binary that runs an autonomous ReAct agent loop. It is provider-agnostic and ships parallel tool execution, persistent memory, an MCP server and client, a Docker sandbox (on by default), a Web UI, and a Telegram bot — with no frameworks and no Python venv." + "text": "odek is a <15 MB static Go binary that runs an autonomous ReAct agent loop. It is provider-agnostic and ships parallel tool execution, persistent memory, an MCP server and client, a Docker sandbox (on by default), a Web UI, and a Telegram bot — with no frameworks and no Python venv." } }, { @@ -123,7 +123,7 @@

GO SMALL. BUILD BIG.

Move fast.
Stay in control.

-

An autonomous agent with a small footprint and a clear set of boundaries. Odek plans, runs tools, and follows through—in one ~11 MB Go binary you can inspect from the inside out.

+

An autonomous agent with a small footprint and a clear set of boundaries. Odek plans, runs tools, and follows through—in one <15 MB Go binary you can inspect from the inside out.

Get started Explore the Web UI diff --git a/docs/llms.txt b/docs/llms.txt index 6184074..daf6748 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -1,6 +1,6 @@ # odek -> odek is a minimal autonomous agent runtime written in Go — a ReAct (Reasoning + Acting) loop with zero frameworks (stdlib plus a few focused packages), shipped as a single ~11 MB static binary with instant startup. It runs tasks from the CLI, an interactive REPL, a web UI, a Telegram bot, scheduled jobs, or as a Go library, and can execute shell commands, edit files, browse the web, transcribe audio, analyze images, spawn sub-agents, and connect to MCP servers. +> odek is a minimal autonomous agent runtime written in Go — a ReAct (Reasoning + Acting) loop with zero frameworks (stdlib plus a few focused packages), shipped as a single <15 MB static binary with instant startup. It runs tasks from the CLI, an interactive REPL, a web UI, a Telegram bot, scheduled jobs, or as a Go library, and can execute shell commands, edit files, browse the web, transcribe audio, analyze images, spawn sub-agents, and connect to MCP servers. Module path: `github.com/BackendStack21/odek`. Repository: https://github.com/BackendStack21/odek