Skip to content
Cinatra Docs

Quickstart

This guide takes you from a freshly installed Cinatra to running your first agent end-to-end. It assumes you have already followed Installation and the app is up at http://localhost:3000.

Expected time: about ten minutes.

1. Create the admin account

Section titled “1. Create the admin account”

Open http://localhost:3000 in a browser. You will be redirected to a sign-up form. Register with an email and password.

The first user to register becomes the platform admin and the owner of the default workspace organization. Every subsequent sign-up creates a regular user account. Admins are the only users who can install agent packages, manage network/registry settings, and access cross-organization administration.

2. Complete the setup wizard

Section titled “2. Complete the setup wizard”

After registering you land in the setup wizard at /setup. It walks through a few one-time decisions:

  1. Encryption key. Cinatra encrypts provider API keys and connector credentials at rest. In development the wizard generates a key and persists it to .env.local. In production this is provided as an environment variable instead.
  2. Instance identity. A display name (e.g. “Acme Demo”) and a short namespace slug (e.g. acme-demo). The namespace is used as part of agent package names you publish from this instance.
  3. LLM provider. Paste an OpenAI API key. OpenAI is the default provider; you can connect Anthropic and Google Gemini later from Administration → LLM Providers (/administration/llm).

Each step has its own page; the wizard skips steps you have already completed if you re-enter it.

3. Connect at least one LLM provider

Section titled “3. Connect at least one LLM provider”

If you skipped the LLM step in the wizard, visit Administration → LLM Providers (/administration/llm) and connect a provider. You need at least one to run any agent.

For the rest of this guide, OpenAI is enough.

4. Install a sample agent

Section titled “4. Install a sample agent”

Visit Administration → Marketplace (/administration/marketplace). The hosted public registry at registry.cinatra.ai ships a handful of starter agents. Pick one that looks simple — for example, URL Title Fetcher (a deterministic agent that fetches a URL and returns its title) or Summarize and Review Page (an LLM-backed page summarizer).

Click Install. The platform downloads the agent package, validates its oas.json, persists it locally, and makes it available under Agents (/agents).

Behind the scenes: the installation creates an agent_templates row, copies the package contents to agents/<vendor>/<slug>/, and registers the agent’s MCP primitive so it becomes callable like any other capability.

5. Run it

Section titled “5. Run it”

Open the Agents sidebar group. The top-level /agents route is now an interactive dashboard of recently used and recently run agents; the full installed-agents list lives at Agents → Status (/agents/status). Click the agent you just installed and use its Run action.

Two patterns appear here, both backed by the same runtime:

  • Setup-step HITL. Before the agent starts, it asks for the inputs declared in its OAS file (a URL, a topic, recipient list, etc.) via a form rendered from the agent’s declared HITL screens.
  • Mid-run HITL. During the run, the agent may pause for a review (a recipient list to approve, a draft email to edit) and ask you to confirm before continuing.

Fill in the inputs, click Start, and watch the run page — you will see typed AG-UI events streaming in real time: tool calls, text chunks, state snapshots, eventually a completion or interrupt event. Reload the page if you like; the stream resumes from the durable Redis-backed event log via the Last-Event-ID header.

6. Watch the standards in action

Section titled “6. Watch the standards in action”

While the run is happening:

  • OAS — the agent definition came from a oas.json file in the installed package; the platform compiled it into the runtime representation when the package was installed.
  • A2A — the run is being executed inside the WayFlow container. The Next.js app reached it over an A2A call.
  • AG-UI — the events you see in the run page (tool calls, message chunks, state snapshots) are AG-UI typed events delivered over Server-Sent Events.
  • A2UI — if the run paused for HITL, the form you saw was rendered from an A2UI surface payload published in parallel to the AG-UI lifecycle stream.

See Open standards in Cinatra for the full breakdown.

7. Let your edits teach the next run (optional)

Section titled “7. Let your edits teach the next run (optional)”

If your admin has enabled skill autosave at /administration/skills, every prompt edit you make inside a HITL surface during a run is captured at the end of that run and turned into a personal skill scoped to you and the agent you just ran. The next time you run the same agent, the platform’s skill-matching engine injects that personal skill back into the agent’s prompt context — the agent already knows your preferences. See Continuous learning and personal skills for the full picture; nothing here is on by default.

8. Try the chat assistant

Section titled “8. Try the chat assistant”

The chat surface at /chat (linked from the main nav) is a built-in AI assistant that can drive every capability of the platform via MCP. Try:

“Create a new agent that summarizes a URL using the page title and the first paragraph.”

The assistant walks through the OAS Flow scaffolding interactively, validates the result, and offers to publish it to your local registry. You can install and run the new agent the same way as any other.

What to do next

Section titled “What to do next”