aia 2.0.0.0.pre.beta2 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (227) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +152 -223
  3. data/README.md +41 -18
  4. data/bin/aia +8 -3
  5. data/lib/aia/aia_completion.bash +2 -3
  6. data/lib/aia/aia_completion.fish +6 -5
  7. data/lib/aia/aia_completion.zsh +2 -3
  8. data/lib/aia/chat_loop.rb +16 -14
  9. data/lib/aia/config/cli_parser.rb +123 -91
  10. data/lib/aia/config/defaults.yml +18 -40
  11. data/lib/aia/config/mcp_parser.rb +30 -36
  12. data/lib/aia/config/model_spec.rb +8 -14
  13. data/lib/aia/config/validator.rb +102 -103
  14. data/lib/aia/config/value_caster.rb +76 -0
  15. data/lib/aia/config.rb +70 -53
  16. data/lib/aia/crew.rb +29 -19
  17. data/lib/aia/debate_handler.rb +27 -10
  18. data/lib/aia/directives/configuration_directives.rb +55 -14
  19. data/lib/aia/directives/context_directives.rb +24 -12
  20. data/lib/aia/directives/execution_directives.rb +18 -23
  21. data/lib/aia/directives/model_directives.rb +41 -104
  22. data/lib/aia/directives/utility_directives.rb +16 -17
  23. data/lib/aia/directives/web_and_file_directives.rb +21 -14
  24. data/lib/aia/fact_asserter.rb +3 -3
  25. data/lib/aia/history_transfer.rb +64 -24
  26. data/lib/aia/logger.rb +14 -46
  27. data/lib/aia/mcp_config_normalizer.rb +27 -14
  28. data/lib/aia/mcp_connection_manager.rb +181 -184
  29. data/lib/aia/mcp_discovery.rb +43 -15
  30. data/lib/aia/mcp_grouper.rb +2 -1
  31. data/lib/aia/mcp_server_config.rb +20 -2
  32. data/lib/aia/mcp_utility.rb +24 -19
  33. data/lib/aia/mention_router.rb +15 -2
  34. data/lib/aia/modality_query.rb +36 -0
  35. data/lib/aia/model_alias_registry.rb +11 -11
  36. data/lib/aia/model_registry.rb +75 -0
  37. data/lib/aia/network_builder.rb +8 -7
  38. data/lib/aia/patches/mcp_stdio_stderr.rb +102 -0
  39. data/lib/aia/patches/ruby_llm_streaming_error.rb +21 -4
  40. data/lib/aia/patches/ruby_llm_tool_param_compat.rb +18 -0
  41. data/lib/aia/pipeline_orchestrator.rb +71 -38
  42. data/lib/aia/prompt_decomposer.rb +1 -1
  43. data/lib/aia/prompt_handler.rb +56 -29
  44. data/lib/aia/provider_registry.rb +105 -0
  45. data/lib/aia/robot_builder.rb +1 -1
  46. data/lib/aia/robot_factory.rb +67 -63
  47. data/lib/aia/robot_sync.rb +79 -0
  48. data/lib/aia/role_catalog.rb +89 -0
  49. data/lib/aia/session.rb +25 -11
  50. data/lib/aia/skill_utils.rb +60 -19
  51. data/lib/aia/spawn_handler.rb +16 -4
  52. data/lib/aia/spawn_spec_parser.rb +6 -7
  53. data/lib/aia/special_mode_handler.rb +28 -25
  54. data/lib/aia/speech.rb +70 -34
  55. data/lib/aia/startup_coordinator.rb +17 -92
  56. data/lib/aia/streaming_runner.rb +10 -2
  57. data/lib/aia/system_prompt_assembler.rb +12 -11
  58. data/lib/aia/task_board.rb +60 -0
  59. data/lib/aia/tool_approver.rb +205 -0
  60. data/lib/aia/tool_filter.rb +1 -10
  61. data/lib/aia/tool_filter_strategy.rb +12 -1
  62. data/lib/aia/tool_introspection.rb +9 -1
  63. data/lib/aia/tool_loader.rb +67 -33
  64. data/lib/aia/tool_utility.rb +6 -5
  65. data/lib/aia/tools/delegate_to_foreman_tool.rb +6 -4
  66. data/lib/aia/tools/recruit_robot_tool.rb +12 -12
  67. data/lib/aia/tools/reskill_robot_tool.rb +7 -7
  68. data/lib/aia/tools/task_board_tool.rb +16 -16
  69. data/lib/aia/trakflow_bridge.rb +14 -8
  70. data/lib/aia/turn_state.rb +31 -8
  71. data/lib/aia/ui_presenter.rb +16 -0
  72. data/lib/aia/utility.rb +6 -24
  73. data/lib/aia/variable_input_collector.rb +0 -3
  74. data/lib/aia/verification_network.rb +9 -10
  75. data/lib/aia/version.rb +1 -9
  76. data/lib/aia.rb +34 -8
  77. metadata +20 -161
  78. data/.better-commits.json +0 -150
  79. data/.config/tocer/configuration.yml +0 -6
  80. data/.envrc +0 -19
  81. data/.loki +0 -11
  82. data/.reek.yml +0 -160
  83. data/.rubocop.yml +0 -116
  84. data/.rubocop_strict.yml +0 -15
  85. data/.version +0 -1
  86. data/COMMITS.md +0 -196
  87. data/IMPLEMENTATION_PLAN.md +0 -506
  88. data/Rakefile +0 -47
  89. data/_typos.toml +0 -10
  90. data/aia.gemspec +0 -92
  91. data/architecture_review.md +0 -314
  92. data/config/aia.yml +0 -13
  93. data/docs/AGENTS.md +0 -40
  94. data/docs/advanced-prompting.md +0 -814
  95. data/docs/assets/images/aia.png +0 -0
  96. data/docs/cli-reference.md +0 -1241
  97. data/docs/configuration.md +0 -747
  98. data/docs/contributing.md +0 -386
  99. data/docs/directives-reference.md +0 -1145
  100. data/docs/examples/index.md +0 -277
  101. data/docs/examples/mcp/index.md +0 -475
  102. data/docs/examples/prompts/analysis/index.md +0 -78
  103. data/docs/examples/prompts/automation/index.md +0 -109
  104. data/docs/examples/prompts/development/index.md +0 -125
  105. data/docs/examples/prompts/index.md +0 -333
  106. data/docs/examples/prompts/learning/index.md +0 -127
  107. data/docs/examples/prompts/writing/index.md +0 -62
  108. data/docs/examples/tools/index.md +0 -282
  109. data/docs/faq.md +0 -578
  110. data/docs/guides/available-models.md +0 -366
  111. data/docs/guides/basic-usage.md +0 -478
  112. data/docs/guides/chat.md +0 -680
  113. data/docs/guides/crew.md +0 -239
  114. data/docs/guides/executable-prompts.md +0 -331
  115. data/docs/guides/first-prompt.md +0 -454
  116. data/docs/guides/getting-started.md +0 -455
  117. data/docs/guides/image-generation.md +0 -507
  118. data/docs/guides/index.md +0 -48
  119. data/docs/guides/local-models.md +0 -306
  120. data/docs/guides/migrate-prompts.md +0 -335
  121. data/docs/guides/models.md +0 -1017
  122. data/docs/guides/shared-tools.md +0 -254
  123. data/docs/guides/tools.md +0 -831
  124. data/docs/index.md +0 -259
  125. data/docs/installation.md +0 -274
  126. data/docs/mcp-integration.md +0 -603
  127. data/docs/prompt_management.md +0 -665
  128. data/docs/security.md +0 -674
  129. data/docs/special_projects_guide.md +0 -386
  130. data/docs/tools-and-mcp-examples.md +0 -1211
  131. data/docs/workflows-and-pipelines.md +0 -636
  132. data/examples/.gitignore +0 -2
  133. data/examples/00_setup_aia.sh +0 -111
  134. data/examples/01_basic_usage.sh +0 -23
  135. data/examples/02_frontmatter.sh +0 -33
  136. data/examples/03_shell_integration.sh +0 -55
  137. data/examples/04_erb_templating.sh +0 -56
  138. data/examples/05_shell_then_erb.sh +0 -38
  139. data/examples/06_prompt_chaining.sh +0 -59
  140. data/examples/07_pipeline.sh +0 -46
  141. data/examples/08_context_files.sh +0 -43
  142. data/examples/09_roles.sh +0 -67
  143. data/examples/10_stdin_piping.sh +0 -49
  144. data/examples/11_multi_model.sh +0 -65
  145. data/examples/12_token_usage.sh +0 -52
  146. data/examples/13_cost_tracking.sh +0 -68
  147. data/examples/14_output_file.sh +0 -91
  148. data/examples/15_parameters.sh +0 -68
  149. data/examples/16_directives.sh +0 -113
  150. data/examples/17_require_and_conditionals.sh +0 -68
  151. data/examples/18_tools.sh +0 -61
  152. data/examples/19_local_tools.sh +0 -34
  153. data/examples/20_mcp_servers.sh +0 -102
  154. data/examples/21_executable_prompts.sh +0 -78
  155. data/examples/22_chat_mode.sh +0 -217
  156. data/examples/23_verify.sh +0 -139
  157. data/examples/24_decompose.sh +0 -139
  158. data/examples/25_spawn.sh +0 -139
  159. data/examples/26_debate.sh +0 -97
  160. data/examples/27_mention_routing.sh +0 -157
  161. data/examples/28_model_switching.sh +0 -106
  162. data/examples/29_agent_harness.sh +0 -177
  163. data/examples/README.md +0 -321
  164. data/examples/advanced_multi_robot_capabilities_without_examples.md +0 -106
  165. data/examples/aia_config.yml +0 -22
  166. data/examples/aia_config_orchestrator.yml +0 -45
  167. data/examples/aia_config_with_mcp.yml +0 -21
  168. data/examples/common.sh +0 -39
  169. data/examples/context/project_goals.md +0 -6
  170. data/examples/context/tech_stack.md +0 -7
  171. data/examples/directives/timestamp_directive.rb +0 -22
  172. data/examples/mcp/filesystem.json +0 -9
  173. data/examples/prompts_dir/analyze.md +0 -2
  174. data/examples/prompts_dir/brainstorm.md +0 -2
  175. data/examples/prompts_dir/conditional.md +0 -17
  176. data/examples/prompts_dir/creative.md +0 -4
  177. data/examples/prompts_dir/erbinfo.md +0 -5
  178. data/examples/prompts_dir/erbinfo_raw.md +0 -8
  179. data/examples/prompts_dir/evaluate.md +0 -2
  180. data/examples/prompts_dir/explain_joke.md +0 -1
  181. data/examples/prompts_dir/explain_recursion.md +0 -1
  182. data/examples/prompts_dir/fun_fact +0 -3
  183. data/examples/prompts_dir/greeting.md +0 -8
  184. data/examples/prompts_dir/greeting_required.md +0 -7
  185. data/examples/prompts_dir/hello.md +0 -1
  186. data/examples/prompts_dir/includes/ruby_facts.md +0 -4
  187. data/examples/prompts_dir/limerick.md +0 -1
  188. data/examples/prompts_dir/list_with_mcp.md +0 -3
  189. data/examples/prompts_dir/pick_best.md +0 -2
  190. data/examples/prompts_dir/project_summary +0 -12
  191. data/examples/prompts_dir/quiz_with_include.md +0 -6
  192. data/examples/prompts_dir/require_demo.md +0 -5
  193. data/examples/prompts_dir/roles/formal.md +0 -3
  194. data/examples/prompts_dir/roles/orchestrator.md +0 -21
  195. data/examples/prompts_dir/roles/pirate.md +0 -3
  196. data/examples/prompts_dir/shell_then_erb.md +0 -6
  197. data/examples/prompts_dir/sort_compare.md +0 -2
  198. data/examples/prompts_dir/summarize_context.md +0 -2
  199. data/examples/prompts_dir/sysinfo.md +0 -5
  200. data/examples/prompts_dir/sysinfo_raw.md +0 -8
  201. data/examples/prompts_dir/tagline.md +0 -1
  202. data/examples/prompts_dir/tell_joke.md +0 -1
  203. data/examples/prompts_dir/tell_joke_with_next.md +0 -4
  204. data/examples/prompts_dir/use_local_tool.md +0 -8
  205. data/examples/prompts_dir/use_tools.md +0 -8
  206. data/examples/prompts_dir/weather.md +0 -2
  207. data/examples/prompts_dir/whats_new.md +0 -2
  208. data/examples/prompts_dir/with_timestamp.md +0 -5
  209. data/examples/requirements/sinatra_taskflow_app.md +0 -139
  210. data/examples/rules/01_classify_ruby.rb +0 -16
  211. data/examples/rules/02_prefer_claude_for_code.rb +0 -19
  212. data/examples/rules/03_gate_prompt_length.rb +0 -19
  213. data/examples/rules/04_tool_selection.rb +0 -41
  214. data/examples/rules/README.md +0 -30
  215. data/examples/run_all.sh +0 -294
  216. data/examples/tools/word_count_tool.rb +0 -30
  217. data/lib/AGENTS.md +0 -57
  218. data/lib/aia/model_switch_handler.rb +0 -100
  219. data/mcp_servers/README.md +0 -110
  220. data/mcp_servers/apple-mcp.json +0 -8
  221. data/mcp_servers/filesystem.json +0 -9
  222. data/mcp_servers/mcp_server_chart.json +0 -11
  223. data/mcp_servers/playwright_one.json +0 -8
  224. data/mcp_servers/playwright_server_definition.json +0 -9
  225. data/mcp_servers/playwright_two.json +0 -8
  226. data/mcp_servers/tavily_mcp_server.json +0 -8
  227. data/mkdocs.yml +0 -169
@@ -1,507 +0,0 @@
1
- # Image Generation
2
-
3
- AIA supports AI-powered image generation through various models, enabling you to create images from text descriptions, modify existing images, and integrate visual content generation into your workflows.
4
-
5
- ## Supported Models
6
-
7
- ### DALL-E Models (OpenAI)
8
- - **DALL-E 3**: Latest and most capable image generation model
9
- - **DALL-E 2**: Previous generation, still available and capable
10
-
11
- ### Image Model Capabilities
12
- ```bash
13
- # Check available image generation models
14
- aia --available-models text_to_image
15
-
16
- # Example output:
17
- # - dall-e-3 (openai) text to image
18
- # - dall-e-2 (openai) text to image
19
- ```
20
-
21
- ## Basic Image Generation
22
-
23
- ### Simple Image Generation
24
- ```bash
25
- # Generate an image with default settings
26
- aia --model dall-e-3 "A serene mountain lake at sunset"
27
-
28
- # Generate with specific size
29
- aia --model dall-e-3 --image-size 1024x1024 "Modern office workspace"
30
-
31
- # Generate with quality settings
32
- aia --model dall-e-3 --image-quality hd "Professional headshot"
33
- ```
34
-
35
- ### Image Configuration Options
36
-
37
- #### Image Size (`--image-size`, `--is`)
38
- ```bash
39
- # Square formats
40
- aia --image-size 1024x1024 "Square image prompt"
41
- aia --is 512x512 "Smaller square image"
42
-
43
- # Landscape formats
44
- aia --image-size 1792x1024 "Wide landscape image"
45
- aia --is 1344x768 "Medium landscape"
46
-
47
- # Portrait formats
48
- aia --image-size 1024x1792 "Tall portrait image"
49
- aia --is 768x1344 "Medium portrait"
50
- ```
51
-
52
- **Available sizes**:
53
- - Square: `256x256`, `512x512`, `1024x1024`
54
- - Landscape: `1792x1024`, `1344x768`
55
- - Portrait: `1024x1792`, `768x1344`
56
-
57
- #### Image Quality (`--image-quality`, `--iq`)
58
- ```bash
59
- # Standard quality (faster, less expensive)
60
- aia --image-quality standard "Quick concept image"
61
-
62
- # HD quality (better detail, more expensive)
63
- aia --image-quality hd "High-quality marketing image"
64
- aia --iq hd "Detailed technical diagram"
65
- ```
66
-
67
- **Quality options**:
68
- - `standard`: Good quality, faster generation, lower cost
69
- - `hd`: Enhanced detail and resolution, slower, higher cost
70
-
71
- #### Image Style (`--style`, `--image-style`)
72
- ```bash
73
- # Vivid style (hyper-real, dramatic colors)
74
- aia --image-style vivid "Dramatic sunset over city skyline"
75
-
76
- # Natural style (more natural, less stylized)
77
- aia --image-style natural "Realistic portrait of a person reading"
78
- aia --style natural "Documentary-style photograph"
79
- ```
80
-
81
- **Style options**:
82
- - `vivid`: Hyper-real and dramatic images
83
- - `natural`: More natural, less stylized results
84
-
85
- ## Advanced Image Generation
86
-
87
- ### Using Prompts for Image Generation
88
- Create reusable image generation prompts:
89
-
90
- ```markdown
91
- # ~/.prompts/product_photography.md
92
- /config model dall-e-3
93
- /config image_size 1024x1024
94
- /config image_quality hd
95
- /config image_style natural
96
-
97
- # Product Photography Generator
98
-
99
- Generate a professional product photograph of: <%= product %>
100
-
101
- Style requirements:
102
- - Clean, minimalist background
103
- - Professional lighting
104
- - Commercial photography style
105
- - <%= lighting || "Soft, even lighting" %>
106
- - <%= background || "White background" %>
107
-
108
- Additional specifications:
109
- - Angle: <%= angle || "45-degree angle" %>
110
- - Context: <%= context || "Isolated product shot" %>
111
- - Mood: <%= mood || "Clean and professional" %>
112
- ```
113
-
114
- ```bash
115
- # Use the prompt
116
- aia product_photography --product "wireless headphones" --lighting "dramatic side lighting"
117
- ```
118
-
119
- ### Complex Image Descriptions
120
- ```markdown
121
- # ~/.prompts/detailed_scene.md
122
- /config model dall-e-3
123
- /config image_size 1792x1024
124
- /config image_quality hd
125
- /config image_style vivid
126
-
127
- # Detailed Scene Generator
128
-
129
- Create a detailed image of: <%= scene_type %>
130
-
131
- ## Visual Elements:
132
- - Setting: <%= setting %>
133
- - Time of day: <%= time_of_day || "golden hour" %>
134
- - Weather: <%= weather || "clear" %>
135
- - Color palette: <%= colors || "warm and inviting" %>
136
-
137
- ## Composition:
138
- - Perspective: <%= perspective || "eye level" %>
139
- - Focal point: <%= focal_point %>
140
- - Depth of field: <%= depth || "shallow depth of field" %>
141
-
142
- ## Style and Mood:
143
- - Art style: <%= art_style || "photorealistic" %>
144
- - Mood: <%= mood || "peaceful and serene" %>
145
- - Technical quality: <%= quality || "professional photography" %>
146
-
147
- Generate a <%= scene_type %> scene with <%= focal_point %> as the main subject,
148
- set in <%= setting %> during <%= time_of_day %>.
149
- ```
150
-
151
- ### Image Series Generation
152
- ```ruby
153
- # ~/.prompts/image_series.md
154
- /config model dall-e-3
155
- /config image_size 1024x1024
156
-
157
- # Image Series Generator
158
-
159
- /ruby
160
- series_theme = '<%= theme %>'
161
- variations = ['<%= var1 %>', '<%= var2 %>', '<%= var3 %>']
162
- base_prompt = '<%= base_description %>'
163
-
164
- puts "Generating #{variations.length} variations of #{series_theme}:"
165
- puts
166
-
167
- variations.each_with_index do |variation, index|
168
- puts "## Image #{index + 1}: #{variation.capitalize}"
169
- puts "#{base_prompt} featuring #{variation}."
170
- puts "Style: Consistent with series theme of #{series_theme}"
171
- puts
172
- end
173
- ```
174
-
175
- ```bash
176
- # Generate a series
177
- aia image_series \
178
- --theme "modern architecture" \
179
- --base_description "Professional architectural photograph" \
180
- --var1 "glass and steel skyscraper" \
181
- --var2 "minimalist residential house" \
182
- --var3 "contemporary office building"
183
- ```
184
-
185
- ## Image Generation Workflows
186
-
187
- ### Marketing Asset Pipeline
188
- ```markdown
189
- # ~/.prompts/marketing_pipeline.md
190
- /pipeline concept_image,hero_image,detail_shots,social_media_variants
191
-
192
- # Marketing Asset Generation Pipeline
193
-
194
- Product: <%= product_name %>
195
- Brand style: <%= brand_style || "modern and clean" %>
196
- Target audience: <%= audience || "professionals" %>
197
-
198
- ## Stage 1: Concept Image
199
- /config model dall-e-3
200
- /config image_size 1024x1024
201
- /config image_style natural
202
-
203
- Generate initial concept image for <%= product_name %>:
204
- - Style: <%= brand_style %>
205
- - Context: Product introduction
206
- - Purpose: Initial concept validation
207
-
208
- /next hero_image
209
- ```
210
-
211
- ### Creative Workflow
212
- ```markdown
213
- # ~/.prompts/creative_workflow.md
214
- /config model dall-e-3
215
- /config image_quality hd
216
- /config image_style vivid
217
-
218
- # Creative Image Workflow
219
-
220
- Theme: <%= creative_theme %>
221
- Artistic direction: <%= art_direction %>
222
-
223
- ## Brainstorming Phase
224
- Generate 3 conceptual variations of <%= creative_theme %>:
225
-
226
- 1. **Abstract interpretation**: Focus on mood and emotion
227
- 2. **Realistic approach**: Photographic, detailed representation
228
- 3. **Stylized version**: Artistic, illustrative style
229
-
230
- Each image should embody <%= art_direction %> while exploring different artistic approaches.
231
- ```
232
-
233
- ## Integration with Other AIA Features
234
-
235
- ### Image Generation in Chat Mode
236
- ```bash
237
- # Start chat with image generation capability
238
- aia --chat --model dall-e-3
239
-
240
- You: Generate an image of a cozy coffee shop interior
241
- AI: I'll create that image for you...
242
-
243
- You: Now make it more modern and minimalist
244
- AI: Here's a more modern version...
245
-
246
- You: Can you create a series showing different times of day?
247
- AI: I'll generate morning, afternoon, and evening versions...
248
- ```
249
-
250
- ### Combining Text and Image Generation
251
- ```markdown
252
- # ~/.prompts/content_with_visuals.md
253
- /config model gpt-4
254
-
255
- # Content + Visuals Generator
256
-
257
- Topic: <%= topic %>
258
-
259
- ## Step 1: Generate Written Content
260
- Create comprehensive content about <%= topic %>:
261
- - Introduction and overview
262
- - Key concepts and explanations
263
- - Practical applications
264
- - Conclusion and takeaways
265
-
266
- ## Step 2: Identify Visual Opportunities
267
- Based on the content, suggest 3-5 images that would enhance understanding:
268
- - Conceptual illustrations
269
- - Diagrams or infographics
270
- - Real-world examples
271
- - Supporting visuals
272
-
273
- ## Step 3: Generate Image Prompts
274
- For each suggested visual, provide detailed DALL-E prompts that would create appropriate images.
275
-
276
- /next generate_supporting_images
277
- ```
278
-
279
- ### Technical Documentation with Visuals
280
- ```markdown
281
- # ~/.prompts/technical_docs_with_images.md
282
- /config model gpt-4
283
-
284
- # Technical Documentation with Visual Aids
285
-
286
- System/Process: <%= system_name %>
287
-
288
- ## Documentation Phase
289
- Create technical documentation for <%= system_name %> including:
290
- - Architecture overview
291
- - Process flows
292
- - Component relationships
293
- - User interfaces
294
-
295
- ## Visual Requirements Analysis
296
- Identify diagrams and illustrations needed:
297
- - System architecture diagrams
298
- - Process flow charts
299
- - UI mockups
300
- - Component diagrams
301
-
302
- ## Image Generation Specifications
303
- For each identified visual need, create detailed prompts for:
304
- - Technical diagram style
305
- - Professional color schemes
306
- - Appropriate level of detail
307
- - Consistent visual language
308
-
309
- /next technical_image_generation
310
- ```
311
-
312
- ## Best Practices for Image Generation
313
-
314
- ### Effective Prompt Writing
315
-
316
- #### Be Specific and Detailed
317
- ```bash
318
- # Vague prompt (poor results)
319
- aia --model dall-e-3 "office space"
320
-
321
- # Detailed prompt (better results)
322
- aia --model dall-e-3 "Modern open-plan office with floor-to-ceiling windows, ergonomic furniture, plants, natural lighting, clean minimal aesthetic, professional photography style"
323
- ```
324
-
325
- #### Use Style and Technical Terms
326
- ```bash
327
- # Include photography terms
328
- aia --model dall-e-3 "Portrait with shallow depth of field, golden hour lighting, 85mm lens perspective"
329
-
330
- # Include art style references
331
- aia --model dall-e-3 "Landscape in the style of landscape photography, dramatic sky, wide angle lens, HDR processing"
332
- ```
333
-
334
- #### Specify Composition Elements
335
- ```bash
336
- # Composition guidance
337
- aia --model dall-e-3 "Centered composition, symmetrical balance, rule of thirds, leading lines toward focal point"
338
- ```
339
-
340
- ### Quality Optimization
341
-
342
- #### Resolution and Size Selection
343
- ```bash
344
- # Choose size based on use case
345
- aia --image-size 1792x1024 "Website hero image" # Landscape
346
- aia --image-size 1024x1792 "Mobile app screenshot" # Portrait
347
- aia --image-size 1024x1024 "Social media post" # Square
348
- ```
349
-
350
- #### Quality vs. Cost Balance
351
- ```bash
352
- # Standard for concepts/drafts
353
- aia --image-quality standard "Initial concept image"
354
-
355
- # HD for final/published images
356
- aia --image-quality hd "Final marketing image"
357
- ```
358
-
359
- ### Iterative Refinement
360
- ```bash
361
- # Generate initial concept
362
- aia --model dall-e-3 --output concept_v1.png "Modern kitchen design"
363
-
364
- # Refine based on results
365
- aia --model dall-e-3 --output concept_v2.png "Modern kitchen with marble countertops, pendant lighting, minimalist cabinets"
366
-
367
- # Final version with specific details
368
- aia --model dall-e-3 --image-quality hd --output final_kitchen.png "Ultra-modern kitchen with white marble waterfall countertops, brass pendant lights, handleless cabinets, large island, professional photography"
369
- ```
370
-
371
- ## Troubleshooting Image Generation
372
-
373
- ### Common Issues
374
-
375
- #### Content Policy Violations
376
- ```
377
- Error: Your request was rejected as a result of our safety system.
378
- ```
379
- **Solution**: Revise prompt to avoid:
380
- - Inappropriate content
381
- - Copyrighted material references
382
- - Specific person names (unless historical figures)
383
-
384
- #### Unclear or Generic Results
385
- **Problem**: Generated images are too generic or don't match expectations
386
-
387
- **Solutions**:
388
- ```bash
389
- # Add more specific details
390
- aia --model dall-e-3 "Specific, detailed description with style, lighting, and composition details"
391
-
392
- # Use technical photography terms
393
- aia --model dall-e-3 "Subject photographed with 50mm lens, f/2.8, natural lighting, professional studio setup"
394
- ```
395
-
396
- #### Size/Quality Issues
397
- **Problem**: Images are not the right dimensions or quality
398
-
399
- **Solutions**:
400
- ```bash
401
- # Specify exact requirements
402
- aia --model dall-e-3 --image-size 1792x1024 --image-quality hd "Detailed prompt"
403
-
404
- # Match use case to settings
405
- aia --is 1024x1024 --iq standard "Social media post" # Standard for social media
406
- aia --is 1792x1024 --iq hd "Website banner" # HD for web headers
407
- ```
408
-
409
- ### Performance Optimization
410
-
411
- #### Batch Generation
412
- ```ruby
413
- # Generate multiple related images
414
- /ruby
415
- concepts = ['<%= concept1 %>', '<%= concept2 %>', '<%= concept3 %>']
416
- base_style = '<%= base_style %>'
417
-
418
- concepts.each_with_index do |concept, index|
419
- puts "\n## Image #{index + 1}: #{concept}"
420
- puts "#{base_style} featuring #{concept}"
421
- end
422
- ```
423
-
424
- #### Cost Management
425
- ```bash
426
- # Use standard quality for iterations
427
- aia --image-quality standard "Draft version for review"
428
-
429
- # Use HD only for finals
430
- aia --image-quality hd "Final approved concept"
431
- ```
432
-
433
- ## Integration Examples
434
-
435
- ### Blog Post with Custom Images
436
- ```markdown
437
- # ~/.prompts/illustrated_blog.md
438
- /config model gpt-4
439
-
440
- # Illustrated Blog Post Generator
441
-
442
- Topic: <%= blog_topic %>
443
- Target audience: <%= audience %>
444
-
445
- ## Content Creation
446
- Write a comprehensive blog post about <%= blog_topic %> for <%= audience %>:
447
- - Engaging introduction
448
- - 3-4 main sections with subheadings
449
- - Practical examples and tips
450
- - Compelling conclusion
451
-
452
- ## Visual Content Planning
453
- For each main section, identify opportunities for custom images:
454
- - Hero image for the post
455
- - Illustrative images for key concepts
456
- - Supporting visuals for examples
457
-
458
- ## Image Generation Prompts
459
- Create detailed DALL-E prompts for each identified visual:
460
- - Consistent style across all images
461
- - Professional quality specifications
462
- - Appropriate for <%= audience %>
463
- - Enhances the written content
464
-
465
- /next generate_blog_images
466
- ```
467
-
468
- ### Product Documentation
469
- ```markdown
470
- # ~/.prompts/product_docs_visual.md
471
- /pipeline analyze_product,create_documentation,identify_visuals,generate_images
472
-
473
- # Product Documentation with Visuals
474
-
475
- Product: <%= product_name %>
476
- Documentation type: <%= doc_type %>
477
-
478
- ## Phase 1: Product Analysis
479
- Analyze <%= product_name %> to understand:
480
- - Key features and benefits
481
- - User interface elements
482
- - Use cases and workflows
483
- - Target user needs
484
-
485
- ## Phase 2: Visual Requirements
486
- Identify images needed for effective documentation:
487
- - Product screenshots/mockups
488
- - Feature highlight images
489
- - User workflow diagrams
490
- - Conceptual illustrations
491
-
492
- /config model dall-e-3
493
- /config image_quality hd
494
- /config image_style natural
495
- ```
496
-
497
- ## Related Documentation
498
-
499
- - [Working with Models](models.md) - Model selection and configuration
500
- - [CLI Reference](../cli-reference.md) - Image generation command options
501
- - [Advanced Prompting](../advanced-prompting.md) - Complex image generation techniques
502
- - [Chat Mode](chat.md) - Interactive image generation
503
- - [Workflows and Pipelines](../workflows-and-pipelines.md) - Image generation workflows
504
-
505
- ---
506
-
507
- Image generation opens up new creative possibilities with AIA. Experiment with different prompts, styles, and configurations to create compelling visual content for your projects!
data/docs/guides/index.md DELETED
@@ -1,48 +0,0 @@
1
- # Guides
2
-
3
- Welcome to the AIA guides section! These comprehensive guides will help you master all aspects of using AIA effectively.
4
-
5
- ## Getting Started
6
-
7
- - [Getting Started](getting-started.md) - Your first steps with AIA
8
- - [Basic Usage Patterns](basic-usage.md) - Common ways to use AIA
9
- - [Your First Prompt](first-prompt.md) - Create and run your first prompt
10
-
11
- ## Core Features
12
-
13
- - [Chat Mode](chat.md) - Interactive conversations with AI models
14
- - [Working with Models](models.md) - Multi-model support and configuration
15
- - [Crews](crew.md) - Address robots with @mention, broadcast with @crew, and recruit members at runtime
16
- - [Available Models](available-models.md) - Complete list of supported AI models
17
- - [Image Generation](image-generation.md) - Generate images with AI
18
- - [Tools Integration](tools.md) - Extend AIA with custom Ruby tools
19
- - [Shared Tools](shared-tools.md) - Ready-to-use tools from the shared_tools gem
20
-
21
- ## Advanced Topics
22
-
23
- - [Prompt Management](../prompt_management.md) - Organize and manage your prompts
24
- - [Advanced Prompting](../advanced-prompting.md) - Master complex prompt techniques
25
- - [Workflows & Pipelines](../workflows-and-pipelines.md) - Chain prompts for complex tasks
26
- - [MCP Integration](../mcp-integration.md) - Use Model Context Protocol clients
27
-
28
- ## Examples and Use Cases
29
-
30
- - [Tools & MCP Examples](../tools-and-mcp-examples.md) - Practical examples
31
- - [Code Examples](../examples/index.md) - Browse example prompts, tools, and configurations
32
-
33
- ## Reference
34
-
35
- - [CLI Parameters](../cli-reference.md) - Complete command-line reference
36
- - [Directives Reference](../directives-reference.md) - All available prompt directives
37
- - [Configuration](../configuration.md) - Complete configuration guide
38
-
39
- ## Tips and Best Practices
40
-
41
- Each guide includes:
42
- - Step-by-step instructions
43
- - Code examples
44
- - Best practices
45
- - Troubleshooting tips
46
- - Links to related topics
47
-
48
- Choose a guide that matches your current needs, or start with [Getting Started](getting-started.md) if you're new to AIA.