Quick Start
This guide takes you from nothing to a built image in a few minutes: create a repo, push some code, and let novem build it.
AI assisted, human approved — novem uses AI to review and keep our documentation up to date.
By the end of this guide you'll have a repo whose latest image you can run
from a job.
The repo comes up as the job build type by default — exactly what we want.
If you haven't already added an SSH key to your profile, do it now (HTTPS works too — see step 3).
ssh-ed25519 AAAAC3NzaC1lZDI1... you@laptop
novem builds whatever you push. A minimal program is enough to get a working image — here a single Python file:
git clone https://x-token:$NOVEM_TOKEN@novem.io/u/<your_username>/r/hello_repo.git
cd hello_repo
cat > main.py <<'EOF'
print("Hello from my novem repo!")
EOF
git add main.py
git commit -m "hello"
git push origin main
The push kicks off a build. novem detects the program, packages it into a container image, and publishes it to your registry.
The build runs asynchronously; follow it on the repo's log path.
When it finishes, your image is available as:
@<your_username>/hello_repo:latest
Note: latest tracks your default branch (main). Every subsequent push
rebuilds it, and each branch and tag gets its own label.
You now have a runnable image. Head over to the jobs quick start to run it — on its own, on a schedule, or as one step in a chain.