Tenki cookbook
Runnable examples for Tenki Sandbox. Each folder under examples/ is a short program you can run against the live API and copy into your own project.
The first example takes about 10 minutes once you have an API key.
Quick start
You need:
- A Tenki account and a
tk_ API key. Create keys at app.tenki.cloud.
- Node.js 24 or later for the JavaScript demos. Several
run.mjs scripts, including the first example, use top-level await using, which Node 22 cannot parse. The verify scripts run on Node 20, which is what CI uses.
- Python 3.12 and uv for the Python examples. They run on Python 3.10 or later. CI uses 3.12. The Covalent example needs your local minor version to match the sandbox image (3.12 on the default image).
- Optional: the Tenki CLI, if you want
tenki login to store the key.
1. Clone
git clone https://github.com/LuxorLabs/cookbook.git
cd cookbook
Each example is self-contained: its own README, source, and dependencies. Nothing installs at the repository root. Install dependencies inside the example you run, with npm install or a virtual environment and that folder's requirements.txt.
2. Set your API key
export TENKI_API_KEY="tk_..."
The JavaScript SDK also reads TENKI_AUTH_TOKEN. Python examples and CI use TENKI_API_KEY. Each example README names the variable it expects.
To store the key, run tenki login --api-key <key>. That writes ~/.config/tenki/config.yaml, and every verify script reads it from there. Some demos, including examples/run-code-in-a-sandbox/run.mjs, read the environment only, so export the key before you run those.
Tenki infers the workspace from the API key. If you set TENKI_WORKSPACE_ID, most scripts pass it through. Most verify and agent scripts also read current_workspace_id from ~/.config/tenki/config.yaml. DeerFlow's provider is the exception: when the account has more than one workspace, set workspace_id in the sandbox: block of its config (DeerFlow example). Authentication and client setup are in the Sandbox SDK guide.
3. Run the first example
Start with Run code in a sandbox. It is the create, execute, and dispose lifecycle in about 15 lines of JavaScript.
cd examples/run-code-in-a-sandbox
npm install
node run.mjs
exit 0 -> 42
The script creates a sandbox, runs python3 -c "print(6 * 7)" inside it, prints the exit code and output, and terminates the sandbox when the script ends, because await using disposes it. The sandbox boots in about 2 seconds and is billed per second.
The same loop in Python is Run code with Python. From the repository root:
cd examples/run-code-python
uv venv --python 3.12
uv pip install -r requirements.txt
.venv/bin/python run.py
run.py prints exit 0 -> 42. It also accepts a key saved by tenki login.
Examples
Open the example closest to what you are building and follow its README. Agent-framework examples need a model provider key, such as OPENAI_API_KEY, to run the agent. Their verify scripts call the sandbox tool directly and do not need that key.
Sandbox API
Agent frameworks
Give an agent a sandbox to run the code it writes.
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
