Skip to main content

​
AgentConfig fields

FieldDefaultDescription
vcpu_count2vCPUs allocated to the VM
mem_size_mib2048Memory in MiB (2048 = 2 GiB)
timeout_seconds1800Max wall-clock time (30 min) before the VM is killed
forward_env[]Host env var names to copy into the VM
env{}Static env vars baked into the config

​
Example

from nightshift import NightshiftApp, AgentConfig

app = NightshiftApp()

@app.agent(AgentConfig(
    vcpu_count=4,
    mem_size_mib=4096,
    timeout_seconds=3600,
    forward_env=["ANTHROPIC_API_KEY"],
    env={"LOG_LEVEL": "debug"},
))
async def heavy_agent(prompt: str):
    yield {"type": "agent.message", "content": f"Running with 4 vCPUs: {prompt}"}

​
Environment variable flow

  • forward_env: Names of environment variables on the caller’s machine. The CLI reads these at nightshift run time and injects them into the VM. They are never stored on the platform.
  • env: Static key-value pairs baked into the agent config. These are stored on the platform alongside the agent definition.
Never put secrets in env — they are stored in the database. Use forward_env for API keys and other credentials so they flow through memory only.