Skip to main content
omium.toml is the project-level config file. It lives at the root of your agent repo and is used by:
  • omium project push
  • omium run (when you run inside the project directory)
  • the SDK (for defaults like project name, workflows directory, etc.)
If you haven’t created one yet, start with First project.

​
Create the file

omium project init --name my-agent

​
Sections

​
[project]

KeyMeaning
nameProject name shown in Automations
versionYour project version string

​
[execution]

KeyMeaning
api_urlFull execution API base URL (includes /api/v1)

​
[tracing]

KeyMeaningDefault
enabledEnable automatic tracingtrue

​
[workflows]

KeyMeaningDefault
directoryWhere workflow definitions live./workflows

​
[checkpoints]

KeyMeaningDefault
enabledEnable checkpointingtrue
intervalAuto-checkpoint interval (seconds)30
max_countMax checkpoints to retain100

​
Example

[project]
name = "my-agent"
version = "0.1.0"

[execution]
api_url = "https://api.omium.ai/api/v1"

[tracing]
enabled = true

[workflows]
directory = "./workflows"

[checkpoints]
enabled = true
interval = 30
max_count = 100

​
Relationship to global config

omium.toml is not where your API key lives. Keys are stored in ~/.omium/config.json (via omium init) or in environment variables. See Environment variables.