Skip to content

Examples

The examples/ directory ships larger, real-world AIMU programs, bigger than a notebook cell, organized by theme. Each subdirectory has its own README with run commands.

Example What it shows Guide
text-refinement/ A generate → judge → refine loop over text, implemented four ways: a code loop, an Agent, the EvaluatorOptimizer workflow, and simulated annealing. GPU-free, Ollama-only. Iterative text refinement
image-refinement/ The same loop over images (diffusion + a vision evaluator), in five variants including image-to-image. Needs aimu[hf] and a GPU. Iterative image refinement
news-summarizer/ One task (summarize recent AI news) solved four ways via --method: Agent, Chain, Parallel, and OrchestratorAgent. Build an orchestrator
skills/ Demo SKILL.md skills (haiku-poet, unit-converter) for SkillAgent discovery, exposed as aimu.paths.skills. Use skills

The text-refinement and image-refinement families are deliberately the same task in two modalities. Read them side by side: the difference between who drives the loop (code vs. agent vs. workflow) and which search strategy wins (greedy vs. hill-climbing vs. annealing) is independent of whether the artifact is a string or an image, a concrete take on agents vs. workflows.