Skip to content
Onboarding · For first-time developers

From zero to first deploy.
~12 minutes, honest.

This page is the honest version of "how fast can a new developer ship something?". Not the marketing 4-minute number (that's build time, not onboarding). 12 minutes is what we observe from "ran the install command" to "read the docs enough to confidently ship a feature" for someone who has never touched the stack. Your mileage will vary — pair programming with a senior cuts it to ~6 minutes.

Opcional · 30 segundos

Rapidinho — nos ajuda a ajustar sua documentação inicial.

Três perguntas pra direcionar você aos exemplos certos. Totalmente opcional — se você só quer instalar, é só pular.

Você tem uma operação manual rodando hoje (algo repetitivo consumindo sua semana)?
Quantas pessoas no seu time?
Qual a sua urgência?

Responda as três pra liberar Salvar. Ou aperte Pular — você decide.

The 5 minute-marked steps

  1. 0:00

    Create your app

    One command scaffolds a working agent — memory, search and chat UI wired. Apache-2.0, no account, no telemetry-by-default. Pick your stack interactively.

    $ npx create-theokit my-app
  2. 0:45

    Enter your project

    Your project is ready with theo.yaml, sensible defaults, health checks, structured logs, and a Dockerfile.

    $ cd my-app && npm install
  3. 2:15

    Run it locally

    The scaffold ships with a worked example for your stack. Run it locally first — no Theo runtime needed yet. Read the code, run the tests, edit a route.

    $ npm run dev
  4. 5:30

    Deploy to the Starter free tier

    Sign in with GitHub. theo deploy builds a signed image, runs health checks, and gives you a live HTTPS URL. No credit card.

    $ theo login && theo deploy
  5. 12:00

    Find the docs you need

    Read the TheoKit framework docs, the deploy/rollback/promote docs for TheoCloud, and the agent-shaped UI component docs. You now know enough to ship a feature.

Promises while you learn

You will not be auto-charged

The Hobby tier is permanently free — and signup includes one month of Starter. No card on file. No upgrade prompts that auto-bill. Cancel anytime — the free tier remains.

You will not lose your code

TheoKit scaffolds standard repos. theo.yaml is open format. Containers are OCI standard. If you walk away from TheoCloud, your code keeps working — standard OCI images and an open theo.yaml rebuild on any container host.

You will not break production

Every deploy is rollback-able with theo rollback. Canary deploys on Pro+. Signed images block deploy on Critical CVEs. You learn the platform safely.

Read the docs

Agent templates, TheoKit framework + theokit-sdk, deploy/rollback/promote for TheoCloud.

Ask in Discord

Founders + 200+ developers. Onboarding questions answered within hours during US/BR working time.

Honest disclosure: 12 minutes is the median observed for developers who already know one of the supported stacks (Node, Go, Python, Rust, Java, Ruby, PHP, Next.js). First-time developers on those stacks will need 30-60 minutes — the bottleneck is reading and understanding the scaffold code, not Theo. We don't make claims we can't back up.