Quickstart
Run a small agent that greets you by name. You’ll use the same starter and get the same result whichever setup you choose.
For a full example with web search, testing, and deployment, follow the Guided walkthrough.
Before you start
Section titled “Before you start”You’ll need a Sapiom account and access to Claude Code or Codex, including its own sign-in. The run in this guide stays on your machine and makes no paid Sapiom capability calls. Your coding agent’s usage still follows its plan.
1. Set up your project
Section titled “1. Set up your project”Download and open Agent Studio:
macOS (Apple silicon) · Windows (x64) · Linux (.deb) · Linux (AppImage)
Install the download and open Sapiom. On macOS, drag the app into Applications first. For AppImage, make the downloaded file executable before opening it. Studio includes Node.js.
- Complete the Sapiom browser sign-in and the first-launch setup prompts.
- Choose Browse templates → Bundled starters → Default starter → Use template. Pick an empty destination folder named
hello-sapiom. - Select Claude Code or Codex in the Coding agent menu, then Start session. Complete that coding agent’s sign-in if prompted. Studio can install Claude Code if neither client is installed.
Paste this into the session:
Keep the default starter unchanged. Install any dependencies it needsand check that it is ready to run locally.You’ll need Node.js 18 or newer and your chosen coding agent installed and signed in.
Create a folder in your terminal:
mkdir hello-sapiomcd hello-sapiomRegister Sapiom MCP and start your coding agent in this folder. Run the pair of commands for your client:
Claude Code
claude mcp add sapiom-project -- npx -y @sapiom/mcpclaudeCodex
codex mcp add sapiom-project -- npx -y @sapiom/mcpcodexPaste this into the session:
Connect my Sapiom account. After I finish signing in, create the defaultSapiom starter in this folder. Keep it unchanged, install its dependencies,and check that it is ready to run locally.Complete the browser sign-in when it opens. Wait for your coding agent to confirm the project is ready.
2. Run the agent
Section titled “2. Run the agent”In the same session, paste:
Run this agent locally with the input {"name": "Ada"}.Show me the greeting from the start step and whether the run completed.3. See the result
Section titled “3. See the result”The start step returns this greeting:
{ "greeting": "hello from Sapiom, Ada" }The run should finish with status completed. The starter’s final step returns { "done": true }; the greeting is in the start step’s result.
You’ve run your first Sapiom agent locally. Try another name by changing Ada in the prompt.
If setup or the run fails, paste the error into the same session and ask your coding agent to fix it. The troubleshooting guide covers common failures.
Build something useful next
Section titled “Build something useful next”© 2026 Sapiom, Inc.