Quick Start Repositories
Create a repository, push a Python program, and build a container image to run in a job.
AI-assisted, human-approvednovem 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.
1. Create the repo
New repositories use the job build type, which produces an image that
a novem job can run.
2. Register a push key
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
3. Add some code and push
Clone the repository and add a Python program. Replace <your_username>
with your novem username and set NOVEM_TOKEN to your API token before
running the commands:
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 starts a build. Novem detects the program, packages it into a container image, and publishes it to your registry.
4. Watch the build
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 tag you push gets its own label. Other branches get
none; see image labels.
Next steps
Follow the jobs quick start to run the image. You can then add a schedule or combine it with other images in a chain.