Skip to main content

Ideon

ooooo oooooooooo.   oooooooooooo   .oooooo.   ooooo      ooo
`888' `888'   `Y8b  `888'     `8  d8P'  `Y8b  `888b.     `8'
 888   888      888  888         888      888  8 `88b.    8
 888   888      888  888oooo8    888      888  8   `88b.  8
 888   888      888  888    "    888      888  8     `88b.8
 888   888     d88'  888       o `88b    d88'  8       `888
o888o o888bood8P'   o888ooooood8  `Y8bood8P'  o8o        `8

Ideon converts a raw idea into a complete content generation run with one or more outputs (article, social, newsletter, landing copy) from a single CLI command.

Quickstart​

npm i -g @telepat/ideon
ideon write "Why async Rust is worth learning" --primary article=1 --secondary x-thread=2 --secondary x-post=1 --style technical

See Installation and Quickstart for full setup including credentials.

What Ideon produces​

  • One generation directory per run (timestamp + slug)
  • One or more markdown outputs (article-1.md, x-thread-1.md, x-post-1.md, etc.)
  • job.json run definition metadata for reproducibility
  • generation.analytics.json with stage and run metrics
  • Shared image assets rendered via a Replicate T2I model for the primary output (article primary includes inline images)

Documentation​

SectionWhat's inside
Getting StartedInstall, configure credentials, run first multi-output generation
GuidesConfiguration, writing framework, job files, pipeline stages, output structure
ReferenceCLI flags, content targets, styles, environment variables, supported T2I models
TechnicalArchitecture, LLM/image pipeline, testing
ContributingDev setup, adding models/stages/settings, releasing

Required credentials​

  • OpenRouter API key — for LLM calls (planning, article writing, channel outputs)
  • Replicate API token — for image rendering

Store them interactively: ideon settings — or set IDEON_OPENROUTER_API_KEY / IDEON_REPLICATE_API_TOKEN as environment variables.

Use --dry-run to test pipeline orchestration without making API calls.