Templates

from nullspace import Machine, Template, default_build_logger

builder = (
    Template()
    .from_python_image("3.12")
    .apt_install(["git", "curl"])
    .pip_install(["fastapi", "uvicorn"])
    .set_runtime_envs({"APP_ENV": "demo"})
)

build = Template.build(
    builder,
    name="fastapi-agent",
    tags=["stable"],
    on_log_entry=default_build_logger(),
)

with Machine.create(template=build.canonical_ref) as machine:
    print(machine.commands.run("python3 --version", shell=True).stdout)

import { NullspaceClient } from "@nullspace/sdk";

const client = new NullspaceClient();

const template = await client.templates
  .builder()
  .fromPythonImage("3.12")
  .aptInstall(["git", "curl"])
  .pipInstall(["fastapi", "uvicorn"])
  .build({
    name: "fastapi-agent",
    tags: ["stable"],
    onLogEntry: (entry) => console.log(entry.message),
  });

await using machine = await client.machines.create({
  template: `${template.name}:stable`,
});
const result = await machine.commands.run("python3 --version", { shell: true });
console.log(result.stdout);

nullspace template build \
  --from-python-image 3.12 \
  --apt-install git,curl \
  --pip-install fastapi,uvicorn \
  --set-runtime-env APP_ENV=demo \
  --name fastapi-agent \
  --tag stable

nullspace machine create --template fastapi-agent:stable

# Builds stream structured log events over SSE. The build body is large;
# see the API reference for the full CreateTemplateRequest schema.
curl -N -X POST "${NULLSPACE_API_URL}/v1/templates/build" \
  -H "Authorization: Bearer ${NULLSPACE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "fastapi-agent",
    "tags": ["stable"],
    "base_image": "python:3.12",
    "steps": [
      {"action": "apt_install", "packages": ["git", "curl"]},
      {"action": "pip_install", "packages": ["fastapi", "uvicorn"]}
    ],
    "runtime_config": {"default_envs": {"APP_ENV": "demo"}}
  }'