hoziron init

Initialize Hoziron — creates the ~/.hoziron/ directory with default configuration.

Synopsis

hoziron init [--quick]

Flags

FlagDescription
--quickNon-interactive mode: skip prompts, write defaults (for CI/scripts)

What It Creates

~/.hoziron/
├── config.toml    # Platform configuration
├── .env           # API keys (provider secrets)
└── data/          # SQLite databases, memory stores, packages

Examples

Interactive setup (default)

$ hoziron init
Welcome to Hoziron!

? Select your default provider: anthropic
? Enter your Anthropic API key: sk-ant-***
? Listen address [127.0.0.1:4200]: 

✓ Created ~/.hoziron/config.toml
✓ Saved API key to ~/.hoziron/.env
✓ Created data directory

Next steps:
  hoziron start    Start the daemon
  hoziron chat     Start chatting

Non-interactive (CI/automation)

$ hoziron init --quick
✓ Created ~/.hoziron/config.toml (defaults)
✓ Created ~/.hoziron/.env (empty — set keys manually)
✓ Created data directory

With custom config path

$ hoziron --config /opt/hoziron/config.toml init --quick
✓ Created /opt/hoziron/config.toml

With HOZIRON_HOME

$ export HOZIRON_HOME=/opt/hoziron
$ hoziron init --quick
✓ Created /opt/hoziron/config.toml
✓ Created /opt/hoziron/.env
✓ Created /opt/hoziron/data/

Generated config.toml

The default config created by init:

[default_model]
provider = "anthropic"
model_id = "claude-sonnet-4-20250514"

[providers.anthropic]
api_key_env = "ANTHROPIC_API_KEY"
enabled = true

Notes

  • Running init when ~/.hoziron/ already exists is safe — it won't overwrite existing files
  • Use hoziron reset --confirm to wipe and reinitialize
  • The --quick flag is essential for Docker builds and CI pipelines
  • After init, run hoziron doctor to verify the setup is complete

See Also