Install
uv tool install git+https://github.com/miounet11/Socrates.git
socrates init
export OPENAI_API_KEY=your-keyDocs
Install fast, choose a preset, and generate from a proper brief.
The fastest way to evaluate Socrates is to install the package, inspect built-in presets, generate a starter request file, and run a guided draft.
Immediate workflow
socrates presets
socrates template blog_post --output request.yaml
socrates generate request.yaml --mode guidedCLI reference
The commands that matter most.
`socrates presets`
List built-in content presets and their recommended modes.
`socrates template PRESET`
Generate a starter YAML request that matches a built-in preset.
`socrates frame request.yaml`
Generate only the strategy/rubric layer when you want to inspect it directly.
`socrates generate request.yaml`
Generate content with `auto`, `direct`, `guided`, or `full` mode.
`socrates review draft.md --request request.yaml`
Run the review stage against an existing markdown draft.
`socrates doctor`
Inspect local provider configuration and confirm credentials are present.
`socrates site-generate`
Publish evergreen library pages and rebuild the static library indexes and sitemap.
Starter presets
The built-in presets model the common professional workflows.
| Preset | Mode | Platform | Use |
|---|---|---|---|
| blog_post | guided | blog | Publishable long-form articles with clearer argument structure |
| linkedin_long_post | guided | Operator-style posts with stronger hooks and pacing | |
| value_prop | guided | web | Landing-page and positioning copy |
| industry_analysis | full | blog | Strategic analysis with stronger structure and review |
| content_calendar | full | multi-platform | Editorial planning across channels |
| brand_narrative | full | web | High-stakes positioning and narrative work |
Object model
The product surface is intentionally small.
ContentRequest
The brief. Topic, audience, goal, platform, type, constraints, and tone notes.
ContentFrame
The standard. Pain, persuasion, credibility, tone, anti-patterns, and angle.
ContentOutline
The structure. Hooks, section order, evidence needs, and CTA placement.
ContentDraft and ReviewReport
The deliverable and the editorial audit that keeps the work publishable.
Next step
Use the planner or open the repo.
The website explains the model, but the fastest evaluation path is still: generate a template, run a preset, and inspect the resulting frame and draft.