⚙️ Configuration¶

AgentOS is built to be flexible. All your settings are stored locally on your machine, and you can manage them either through the Web UI or by editing config files directly.

Installation Guide Security & Privacy

Configuration Channels¶

1

Web UI Dashboard¶

The premium way to configure your agents. Press ++cmd+comma++ anywhere in the app to open the Settings panel.

2

Setup Wizard¶

Run agentos setup in your terminal for a guided CLI walkthrough (optional).

3

Raw Config¶

Edit ~/.agentos/config.yaml or projects.yaml for advanced automation and scriptability.

AI Provider Settings¶

Configure your primary LLM source. You can switch providers instantly without data loss.

🤖 Ollama (Free & Local)¶

The gold standard for privacy.

ollama_model: llama3.2:latest
ollama_url: http://localhost:11434

Ollama Setup →

☁️ OpenAI¶

Classic high-performance.

openai_api_key: sk-proj-...
openai_model: gpt-4o

✨ Anthropic¶

Superior PM reasoning.

anthropic_api_key: sk-ant-...
anthropic_model: claude-3-5-sonnet

🌐 Google Gemini¶

Huge context windows.

gemini_api_key: AIza...
gemini_model: gemini-2.0-flash

Project Tracking¶

Define your projects in ~/.agentos/projects.yaml. A single project can aggregate data from multiple repositories and boards.

projects:
  - name: Core Platform
    id: core-platform
    color: "#7C3AED"
    github:
      repos:
        - myorg/frontend
        - myorg/backend
      days_to_fetch: 30
    jira:
      - project_key: ENG
        board_id: 101
    tags:
      - critical
      - v1.0

GUI Management

You don't need to touch YAML to manage projects. Use the Projects view in the Web UI to add, edit, or color-code your workspaces with a few clicks.

🔑 License & Identity¶

License credentials can be provided via a .watchtower.json file placed next to the agentos binary:

{
  "url": "https://watchtower.unicolab.io",
  "license_key": "AGENT-XXXX-XXXX",
  "kid": "credential-id",
  "secret": "credential-secret"
}

Alternatively, set them as environment variables: WATCHTOWER_LICENSE_KEY, WATCHTOWER_KID, WATCHTOWER_SECRET.

Server Customization¶

Setting	Default	Description
`port`	`18080`	Local HTTP server port
`host`	`0.0.0.0`	Bind address (use `127.0.0.1` for extra security)
`auto_open`	`true`	Automatically open your browser on startup
`storage_path`	`~/.agentos`	Base directory for DB and configuration

Connect GitHub → Connect Jira →