strands-zero

Strands Agents tools for the Zero programming language.

Wraps the official zero CLI as a set of @tool-decorated Python functions so AI agents (Claude, Strands, anything compatible) can write, type-check, compile, run, ship, and inspect Zero programs with structured JSON feedback.

Zero is the programming language for agents — small native tools, explicit effects, predictable memory, and machine-readable compiler output.

Install

pip install strands-zero

This installs the Python wrappers. You also need the Zero compiler binary:

# one-shot from the package
strands-zero-install

# or manually
curl -fsSL https://zerolang.ai/install.sh | bash
export PATH="$HOME/.zero/bin:$PATH"

strands-zero finds the binary in this order:

1. $ZERO_BIN env var
2. zero on $PATH
3. ~/.zero/bin/zero

Quick start

from strands import Agent
from strands_zero import (
    zero_write, zero_check, zero_run, zero_build,
    zero_explain, zero_fix, zero_doctor, zero_skills,
    zero_graph, zero_size, zero_test, zero_version,
)

agent = Agent(
    tools=[
        zero_write, zero_check, zero_run, zero_build,
        zero_explain, zero_fix, zero_doctor, zero_skills,
    ],
    system_prompt="You are a Zero language expert. Use zero_skills('get','zero-language',full=True) when unsure of syntax.",
)

agent("Write a Zero program that prints the first 10 fibonacci numbers, type-check it, then run it.")

Tools

All tools accept a cwd arg; build/run tools accept timeout. JSON-capable tools default to json_output=True and parse stdout into result["json"].

Manual usage (no agent)

from strands_zero import zero_write, zero_run

write = zero_write('''
pub fun main(world: World) -> Void raises {
    check world.out.write("hello\\n")
}
''')

run = zero_run(write["path"])
print(run["stdout"])  # hello

Why?

Zero exposes everything an agent needs through --json flags (check --json, fix --plan --json, graph --json, size --json, doctor --json, ...). This package gives that surface area to a Strands agent verbatim, so an agent can iterate on Zero code with the same explicit, machine-readable feedback the language is designed for.

License

Apache-2.0