robot_lab 0.1.0 → 0.2.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 (242) hide show
  1. checksums.yaml +4 -4
  2. data/.architecture/AGENTS.md +32 -0
  3. data/.architecture/config.yml +8 -0
  4. data/.architecture/members.yml +60 -0
  5. data/.architecture/reviews/feature-free-will.md +490 -0
  6. data/.architecture/reviews/overall-codebase.md +427 -0
  7. data/.claude/settings.local.json +57 -0
  8. data/.codex/config.toml +2 -0
  9. data/.irbrc +2 -2
  10. data/.rubocop.yml +172 -0
  11. data/CHANGELOG.md +72 -0
  12. data/CLAUDE.md +139 -0
  13. data/README.md +91 -95
  14. data/Rakefile +109 -3
  15. data/agent2agent_review.md +192 -0
  16. data/agentf_improvements.md +253 -0
  17. data/agents.md +14 -0
  18. data/docs/examples/index.md +37 -2
  19. data/docs/getting-started/configuration.md +20 -7
  20. data/docs/guides/index.md +16 -16
  21. data/docs/guides/knowledge.md +7 -1
  22. data/docs/guides/observability.md +132 -0
  23. data/docs/index.md +30 -3
  24. data/docs/superpowers/plans/2026-05-06-agentskills.md +1303 -0
  25. data/docs/superpowers/specs/2026-05-06-agentskills-design.md +247 -0
  26. data/examples/.envrc +1 -0
  27. data/examples/01_simple_robot.rb +5 -9
  28. data/examples/02_tools.rb +5 -9
  29. data/examples/03_network.rb +8 -9
  30. data/examples/04_mcp.rb +21 -29
  31. data/examples/05_streaming.rb +12 -18
  32. data/examples/06_prompt_templates.rb +11 -19
  33. data/examples/07_network_memory.rb +16 -31
  34. data/examples/08_llm_config.rb +10 -22
  35. data/examples/09_chaining.rb +16 -27
  36. data/examples/10_memory.rb +12 -28
  37. data/examples/11_network_introspection.rb +15 -29
  38. data/examples/12_message_bus.rb +5 -12
  39. data/examples/13_spawn.rb +5 -10
  40. data/examples/14_rusty_circuit/.envrc +1 -0
  41. data/examples/14_rusty_circuit/comic.rb +2 -0
  42. data/examples/14_rusty_circuit/heckler.rb +1 -1
  43. data/examples/14_rusty_circuit/open_mic.rb +1 -3
  44. data/examples/14_rusty_circuit/scout.rb +2 -0
  45. data/examples/15_memory_network_and_bus/.envrc +1 -0
  46. data/examples/15_memory_network_and_bus/editorial_pipeline.rb +6 -3
  47. data/examples/15_memory_network_and_bus/linux_writer.rb +1 -1
  48. data/examples/15_memory_network_and_bus/output/combined_article.md +6 -6
  49. data/examples/15_memory_network_and_bus/output/final_article.md +6 -8
  50. data/examples/15_memory_network_and_bus/output/linux_draft.md +4 -2
  51. data/examples/15_memory_network_and_bus/output/mac_draft.md +3 -3
  52. data/examples/15_memory_network_and_bus/output/memory.json +6 -6
  53. data/examples/15_memory_network_and_bus/output/revision_1.md +10 -11
  54. data/examples/15_memory_network_and_bus/output/revision_2.md +6 -8
  55. data/examples/15_memory_network_and_bus/output/windows_draft.md +3 -3
  56. data/examples/16_writers_room/.envrc +1 -0
  57. data/examples/16_writers_room/writers_room.rb +2 -4
  58. data/examples/17_skills.rb +8 -17
  59. data/examples/18_rails/Gemfile +1 -0
  60. data/examples/19_token_tracking.rb +9 -15
  61. data/examples/20_circuit_breaker.rb +10 -19
  62. data/examples/21_learning_loop.rb +11 -20
  63. data/examples/22_context_compression.rb +6 -13
  64. data/examples/23_convergence.rb +6 -17
  65. data/examples/24_structured_delegation.rb +11 -15
  66. data/examples/25_history_search.rb +5 -12
  67. data/examples/26_document_store.rb +6 -13
  68. data/examples/27_incident_response/incident_response.rb +4 -5
  69. data/examples/28_mcp_discovery.rb +8 -11
  70. data/examples/29_ractor_tools.rb +4 -9
  71. data/examples/30_ractor_network.rb +10 -19
  72. data/examples/31_launch_assessment.rb +10 -23
  73. data/examples/32_newsletter_reader.rb +188 -0
  74. data/examples/33_stock_generator.rb +80 -0
  75. data/examples/33_stock_predictor.rb +306 -0
  76. data/examples/34_agentskills.rb +72 -0
  77. data/examples/README.md +1 -1
  78. data/examples/common.rb +76 -0
  79. data/examples/ruboruby.md +423 -0
  80. data/examples/temp.md +51 -0
  81. data/lib/robot_lab/agent_skill.rb +63 -0
  82. data/lib/robot_lab/agent_skill_catalog.rb +74 -0
  83. data/lib/robot_lab/ask_user.rb +2 -2
  84. data/lib/robot_lab/bus_poller.rb +12 -5
  85. data/lib/robot_lab/config.rb +1 -12
  86. data/lib/robot_lab/delegation_future.rb +1 -1
  87. data/lib/robot_lab/doom_loop_detector.rb +98 -0
  88. data/lib/robot_lab/history_compressor.rb +4 -10
  89. data/lib/robot_lab/mcp/client.rb +1 -2
  90. data/lib/robot_lab/mcp/connection_poller.rb +3 -3
  91. data/lib/robot_lab/mcp/server.rb +1 -1
  92. data/lib/robot_lab/mcp/server_discovery.rb +0 -2
  93. data/lib/robot_lab/memory.rb +32 -27
  94. data/lib/robot_lab/memory_change.rb +2 -2
  95. data/lib/robot_lab/message.rb +4 -4
  96. data/lib/robot_lab/network.rb +11 -6
  97. data/lib/robot_lab/robot/agent_skill_matching.rb +99 -0
  98. data/lib/robot_lab/robot/bus_messaging.rb +9 -27
  99. data/lib/robot_lab/robot/history_search.rb +4 -1
  100. data/lib/robot_lab/robot/mcp_management.rb +5 -11
  101. data/lib/robot_lab/robot/template_rendering.rb +60 -40
  102. data/lib/robot_lab/robot.rb +323 -206
  103. data/lib/robot_lab/robot_result.rb +6 -5
  104. data/lib/robot_lab/run_config.rb +5 -11
  105. data/lib/robot_lab/script_tool.rb +76 -0
  106. data/lib/robot_lab/state_proxy.rb +7 -5
  107. data/lib/robot_lab/tool.rb +3 -3
  108. data/lib/robot_lab/tool_config.rb +1 -1
  109. data/lib/robot_lab/tool_manifest.rb +5 -7
  110. data/lib/robot_lab/user_message.rb +2 -2
  111. data/lib/robot_lab/version.rb +1 -1
  112. data/lib/robot_lab/waiter.rb +1 -1
  113. data/lib/robot_lab.rb +41 -52
  114. data/logfile +8 -0
  115. data/mkdocs.yml +2 -3
  116. data/robot_concurrency.md +38 -0
  117. data/simple_acp_review.md +298 -0
  118. data/site/404.html +2300 -0
  119. data/site/api/core/index.html +2706 -0
  120. data/site/api/core/memory/index.html +3793 -0
  121. data/site/api/core/network/index.html +3500 -0
  122. data/site/api/core/robot/index.html +4566 -0
  123. data/site/api/core/state/index.html +3390 -0
  124. data/site/api/core/tool/index.html +3843 -0
  125. data/site/api/index.html +2635 -0
  126. data/site/api/mcp/client/index.html +3435 -0
  127. data/site/api/mcp/index.html +2783 -0
  128. data/site/api/mcp/server/index.html +3252 -0
  129. data/site/api/mcp/transports/index.html +3352 -0
  130. data/site/api/messages/index.html +2641 -0
  131. data/site/api/messages/text-message/index.html +3087 -0
  132. data/site/api/messages/tool-call-message/index.html +3159 -0
  133. data/site/api/messages/tool-result-message/index.html +3252 -0
  134. data/site/api/messages/user-message/index.html +3212 -0
  135. data/site/api/streaming/context/index.html +3282 -0
  136. data/site/api/streaming/events/index.html +3347 -0
  137. data/site/api/streaming/index.html +2738 -0
  138. data/site/architecture/core-concepts/index.html +3757 -0
  139. data/site/architecture/index.html +2797 -0
  140. data/site/architecture/message-flow/index.html +3238 -0
  141. data/site/architecture/network-orchestration/index.html +3433 -0
  142. data/site/architecture/robot-execution/index.html +3140 -0
  143. data/site/architecture/state-management/index.html +3498 -0
  144. data/site/assets/css/custom.css +56 -0
  145. data/site/assets/images/favicon.png +0 -0
  146. data/site/assets/images/robot_lab.jpg +0 -0
  147. data/site/assets/javascripts/bundle.79ae519e.min.js +16 -0
  148. data/site/assets/javascripts/bundle.79ae519e.min.js.map +7 -0
  149. data/site/assets/javascripts/lunr/min/lunr.ar.min.js +1 -0
  150. data/site/assets/javascripts/lunr/min/lunr.da.min.js +18 -0
  151. data/site/assets/javascripts/lunr/min/lunr.de.min.js +18 -0
  152. data/site/assets/javascripts/lunr/min/lunr.du.min.js +18 -0
  153. data/site/assets/javascripts/lunr/min/lunr.el.min.js +1 -0
  154. data/site/assets/javascripts/lunr/min/lunr.es.min.js +18 -0
  155. data/site/assets/javascripts/lunr/min/lunr.fi.min.js +18 -0
  156. data/site/assets/javascripts/lunr/min/lunr.fr.min.js +18 -0
  157. data/site/assets/javascripts/lunr/min/lunr.he.min.js +1 -0
  158. data/site/assets/javascripts/lunr/min/lunr.hi.min.js +1 -0
  159. data/site/assets/javascripts/lunr/min/lunr.hu.min.js +18 -0
  160. data/site/assets/javascripts/lunr/min/lunr.hy.min.js +1 -0
  161. data/site/assets/javascripts/lunr/min/lunr.it.min.js +18 -0
  162. data/site/assets/javascripts/lunr/min/lunr.ja.min.js +1 -0
  163. data/site/assets/javascripts/lunr/min/lunr.jp.min.js +1 -0
  164. data/site/assets/javascripts/lunr/min/lunr.kn.min.js +1 -0
  165. data/site/assets/javascripts/lunr/min/lunr.ko.min.js +1 -0
  166. data/site/assets/javascripts/lunr/min/lunr.multi.min.js +1 -0
  167. data/site/assets/javascripts/lunr/min/lunr.nl.min.js +18 -0
  168. data/site/assets/javascripts/lunr/min/lunr.no.min.js +18 -0
  169. data/site/assets/javascripts/lunr/min/lunr.pt.min.js +18 -0
  170. data/site/assets/javascripts/lunr/min/lunr.ro.min.js +18 -0
  171. data/site/assets/javascripts/lunr/min/lunr.ru.min.js +18 -0
  172. data/site/assets/javascripts/lunr/min/lunr.sa.min.js +1 -0
  173. data/site/assets/javascripts/lunr/min/lunr.stemmer.support.min.js +1 -0
  174. data/site/assets/javascripts/lunr/min/lunr.sv.min.js +18 -0
  175. data/site/assets/javascripts/lunr/min/lunr.ta.min.js +1 -0
  176. data/site/assets/javascripts/lunr/min/lunr.te.min.js +1 -0
  177. data/site/assets/javascripts/lunr/min/lunr.th.min.js +1 -0
  178. data/site/assets/javascripts/lunr/min/lunr.tr.min.js +18 -0
  179. data/site/assets/javascripts/lunr/min/lunr.vi.min.js +1 -0
  180. data/site/assets/javascripts/lunr/min/lunr.zh.min.js +1 -0
  181. data/site/assets/javascripts/lunr/tinyseg.js +206 -0
  182. data/site/assets/javascripts/lunr/wordcut.js +6708 -0
  183. data/site/assets/javascripts/workers/search.2c215733.min.js +42 -0
  184. data/site/assets/javascripts/workers/search.2c215733.min.js.map +7 -0
  185. data/site/assets/stylesheets/main.484c7ddc.min.css +1 -0
  186. data/site/assets/stylesheets/main.484c7ddc.min.css.map +1 -0
  187. data/site/assets/stylesheets/palette.ab4e12ef.min.css +1 -0
  188. data/site/assets/stylesheets/palette.ab4e12ef.min.css.map +1 -0
  189. data/site/concepts/index.html +3455 -0
  190. data/site/examples/basic-chat/index.html +2880 -0
  191. data/site/examples/index.html +2907 -0
  192. data/site/examples/mcp-server/index.html +3018 -0
  193. data/site/examples/multi-robot-network/index.html +3131 -0
  194. data/site/examples/rails-application/index.html +3329 -0
  195. data/site/examples/tool-usage/index.html +3085 -0
  196. data/site/getting-started/configuration/index.html +3745 -0
  197. data/site/getting-started/index.html +2572 -0
  198. data/site/getting-started/installation/index.html +2981 -0
  199. data/site/getting-started/quick-start/index.html +2942 -0
  200. data/site/guides/building-robots/index.html +4290 -0
  201. data/site/guides/creating-networks/index.html +3858 -0
  202. data/site/guides/index.html +2586 -0
  203. data/site/guides/mcp-integration/index.html +3581 -0
  204. data/site/guides/memory/index.html +3586 -0
  205. data/site/guides/rails-integration/index.html +4019 -0
  206. data/site/guides/streaming/index.html +3157 -0
  207. data/site/guides/using-tools/index.html +3802 -0
  208. data/site/index.html +2671 -0
  209. data/site/search/search_index.json +1 -0
  210. data/site/sitemap.xml +183 -0
  211. data/site/sitemap.xml.gz +0 -0
  212. data/site/tags.json +1 -0
  213. data/temp.md +6 -0
  214. data/tool_manifest_plan.md +155 -0
  215. metadata +154 -92
  216. data/docs/examples/rails-application.md +0 -419
  217. data/docs/guides/ractor-parallelism.md +0 -364
  218. data/docs/guides/rails-integration.md +0 -681
  219. data/docs/superpowers/plans/2026-04-14-ractor-integration.md +0 -1538
  220. data/docs/superpowers/specs/2026-04-14-ractor-integration-design.md +0 -258
  221. data/lib/generators/robot_lab/install_generator.rb +0 -90
  222. data/lib/generators/robot_lab/job_generator.rb +0 -40
  223. data/lib/generators/robot_lab/robot_generator.rb +0 -55
  224. data/lib/generators/robot_lab/templates/initializer.rb.tt +0 -42
  225. data/lib/generators/robot_lab/templates/job.rb.tt +0 -21
  226. data/lib/generators/robot_lab/templates/migration.rb.tt +0 -32
  227. data/lib/generators/robot_lab/templates/result_model.rb.tt +0 -52
  228. data/lib/generators/robot_lab/templates/robot.rb.tt +0 -31
  229. data/lib/generators/robot_lab/templates/robot_job.rb.tt +0 -18
  230. data/lib/generators/robot_lab/templates/robot_test.rb.tt +0 -34
  231. data/lib/generators/robot_lab/templates/routing_robot.rb.tt +0 -59
  232. data/lib/generators/robot_lab/templates/thread_model.rb.tt +0 -40
  233. data/lib/robot_lab/document_store.rb +0 -155
  234. data/lib/robot_lab/ractor_boundary.rb +0 -42
  235. data/lib/robot_lab/ractor_job.rb +0 -37
  236. data/lib/robot_lab/ractor_memory_proxy.rb +0 -85
  237. data/lib/robot_lab/ractor_network_scheduler.rb +0 -154
  238. data/lib/robot_lab/ractor_worker_pool.rb +0 -117
  239. data/lib/robot_lab/rails_integration/engine.rb +0 -29
  240. data/lib/robot_lab/rails_integration/job.rb +0 -158
  241. data/lib/robot_lab/rails_integration/railtie.rb +0 -51
  242. data/lib/robot_lab/rails_integration/turbo_stream_callbacks.rb +0 -72
data/site/index.html ADDED
@@ -0,0 +1,2671 @@
1
+
2
+ <!doctype html>
3
+ <html lang="en" class="no-js">
4
+ <head>
5
+
6
+ <meta charset="utf-8">
7
+ <meta name="viewport" content="width=device-width,initial-scale=1">
8
+
9
+ <meta name="description" content="Multi-robot LLM workflow orchestration for Ruby">
10
+
11
+
12
+ <meta name="author" content="Dewayne VanHoozer">
13
+
14
+
15
+ <link rel="canonical" href="https://madbomber.github.io/robot_lab/">
16
+
17
+
18
+
19
+ <link rel="next" href="concepts/">
20
+
21
+
22
+
23
+
24
+
25
+ <link rel="icon" href="assets/images/favicon.png">
26
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.1">
27
+
28
+
29
+
30
+ <title>Overview - RobotLab</title>
31
+
32
+
33
+
34
+ <link rel="stylesheet" href="assets/stylesheets/main.484c7ddc.min.css">
35
+
36
+
37
+ <link rel="stylesheet" href="assets/stylesheets/palette.ab4e12ef.min.css">
38
+
39
+
40
+
41
+
42
+
43
+
44
+
45
+
46
+
47
+
48
+
49
+
50
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
51
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
52
+ <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
53
+
54
+
55
+
56
+ <link rel="stylesheet" href="assets/css/custom.css">
57
+
58
+ <script>__md_scope=new URL(".",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
59
+
60
+
61
+
62
+
63
+
64
+
65
+
66
+ </head>
67
+
68
+
69
+
70
+
71
+
72
+
73
+
74
+
75
+
76
+ <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-purple" data-md-color-accent="amber">
77
+
78
+
79
+ <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
80
+ <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
81
+ <label class="md-overlay" for="__drawer"></label>
82
+ <div data-md-component="skip">
83
+
84
+
85
+ <a href="#robotlab" class="md-skip">
86
+ Skip to content
87
+ </a>
88
+
89
+ </div>
90
+ <div data-md-component="announce">
91
+
92
+ </div>
93
+
94
+
95
+
96
+
97
+
98
+
99
+ <header class="md-header md-header--shadow md-header--lifted" data-md-component="header">
100
+ <nav class="md-header__inner md-grid" aria-label="Header">
101
+ <a href="." title="RobotLab" class="md-header__button md-logo" aria-label="RobotLab" data-md-component="logo">
102
+
103
+
104
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2a2 2 0 0 1 2 2c0 .74-.4 1.39-1 1.73V7h1a7 7 0 0 1 7 7h1a1 1 0 0 1 1 1v3a1 1 0 0 1-1 1h-1v1a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-1H2a1 1 0 0 1-1-1v-3a1 1 0 0 1 1-1h1a7 7 0 0 1 7-7h1V5.73c-.6-.34-1-.99-1-1.73a2 2 0 0 1 2-2M7.5 13A2.5 2.5 0 0 0 5 15.5 2.5 2.5 0 0 0 7.5 18a2.5 2.5 0 0 0 2.5-2.5A2.5 2.5 0 0 0 7.5 13m9 0a2.5 2.5 0 0 0-2.5 2.5 2.5 2.5 0 0 0 2.5 2.5 2.5 2.5 0 0 0 2.5-2.5 2.5 2.5 0 0 0-2.5-2.5"/></svg>
105
+
106
+ </a>
107
+ <label class="md-header__button md-icon" for="__drawer">
108
+
109
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
110
+ </label>
111
+ <div class="md-header__title" data-md-component="header-title">
112
+ <div class="md-header__ellipsis">
113
+ <div class="md-header__topic">
114
+ <span class="md-ellipsis">
115
+ RobotLab
116
+ </span>
117
+ </div>
118
+ <div class="md-header__topic" data-md-component="header-topic">
119
+ <span class="md-ellipsis">
120
+
121
+ Overview
122
+
123
+ </span>
124
+ </div>
125
+ </div>
126
+ </div>
127
+
128
+
129
+ <form class="md-header__option" data-md-component="palette">
130
+
131
+
132
+
133
+
134
+ <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-purple" data-md-color-accent="amber" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_0">
135
+
136
+ <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
137
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
138
+ </label>
139
+
140
+
141
+
142
+
143
+
144
+ <input class="md-option" data-md-color-media="" data-md-color-scheme="slate" data-md-color-primary="deep-purple" data-md-color-accent="amber" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_1">
145
+
146
+ <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
147
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
148
+ </label>
149
+
150
+
151
+ </form>
152
+
153
+
154
+
155
+ <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
156
+
157
+
158
+
159
+
160
+
161
+ <label class="md-header__button md-icon" for="__search">
162
+
163
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
164
+ </label>
165
+ <div class="md-search" data-md-component="search" role="dialog">
166
+ <label class="md-search__overlay" for="__search"></label>
167
+ <div class="md-search__inner" role="search">
168
+ <form class="md-search__form" name="search">
169
+ <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
170
+ <label class="md-search__icon md-icon" for="__search">
171
+
172
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
173
+
174
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
175
+ </label>
176
+ <nav class="md-search__options" aria-label="Search">
177
+
178
+ <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
179
+
180
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
181
+ </a>
182
+
183
+ <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
184
+
185
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
186
+ </button>
187
+ </nav>
188
+
189
+ <div class="md-search__suggest" data-md-component="search-suggest"></div>
190
+
191
+ </form>
192
+ <div class="md-search__output">
193
+ <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
194
+ <div class="md-search-result" data-md-component="search-result">
195
+ <div class="md-search-result__meta">
196
+ Initializing search
197
+ </div>
198
+ <ol class="md-search-result__list" role="presentation"></ol>
199
+ </div>
200
+ </div>
201
+ </div>
202
+ </div>
203
+ </div>
204
+
205
+
206
+
207
+ <div class="md-header__source">
208
+ <a href="https://github.com/madbomber/robot_lab" title="Go to repository" class="md-source" data-md-component="source">
209
+ <div class="md-source__icon md-icon">
210
+
211
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
212
+ </div>
213
+ <div class="md-source__repository">
214
+ madbomber/robot_lab
215
+ </div>
216
+ </a>
217
+ </div>
218
+
219
+ </nav>
220
+
221
+
222
+
223
+ <nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
224
+ <div class="md-grid">
225
+ <ul class="md-tabs__list">
226
+
227
+
228
+
229
+
230
+
231
+
232
+
233
+
234
+
235
+
236
+ <li class="md-tabs__item md-tabs__item--active">
237
+ <a href="." class="md-tabs__link">
238
+
239
+
240
+
241
+
242
+
243
+ Home
244
+
245
+ </a>
246
+ </li>
247
+
248
+
249
+
250
+
251
+
252
+
253
+
254
+
255
+
256
+
257
+
258
+ <li class="md-tabs__item">
259
+ <a href="getting-started/" class="md-tabs__link">
260
+
261
+
262
+
263
+
264
+
265
+ Getting Started
266
+
267
+ </a>
268
+ </li>
269
+
270
+
271
+
272
+
273
+
274
+
275
+
276
+
277
+
278
+
279
+
280
+ <li class="md-tabs__item">
281
+ <a href="architecture/" class="md-tabs__link">
282
+
283
+
284
+
285
+
286
+
287
+ Architecture
288
+
289
+ </a>
290
+ </li>
291
+
292
+
293
+
294
+
295
+
296
+
297
+
298
+
299
+
300
+
301
+
302
+ <li class="md-tabs__item">
303
+ <a href="guides/" class="md-tabs__link">
304
+
305
+
306
+
307
+
308
+
309
+ Guides
310
+
311
+ </a>
312
+ </li>
313
+
314
+
315
+
316
+
317
+
318
+
319
+
320
+
321
+
322
+
323
+
324
+ <li class="md-tabs__item">
325
+ <a href="api/" class="md-tabs__link">
326
+
327
+
328
+
329
+
330
+
331
+ API Reference
332
+
333
+ </a>
334
+ </li>
335
+
336
+
337
+
338
+
339
+
340
+
341
+
342
+
343
+
344
+
345
+
346
+ <li class="md-tabs__item">
347
+ <a href="examples/" class="md-tabs__link">
348
+
349
+
350
+
351
+
352
+
353
+ Examples
354
+
355
+ </a>
356
+ </li>
357
+
358
+
359
+
360
+
361
+ </ul>
362
+ </div>
363
+ </nav>
364
+
365
+
366
+ </header>
367
+
368
+ <div class="md-container" data-md-component="container">
369
+
370
+
371
+
372
+
373
+ <main class="md-main" data-md-component="main">
374
+ <div class="md-main__inner md-grid">
375
+
376
+
377
+
378
+ <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
379
+ <div class="md-sidebar__scrollwrap">
380
+ <div class="md-sidebar__inner">
381
+
382
+
383
+
384
+
385
+
386
+
387
+ <nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
388
+ <label class="md-nav__title" for="__drawer">
389
+ <a href="." title="RobotLab" class="md-nav__button md-logo" aria-label="RobotLab" data-md-component="logo">
390
+
391
+
392
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2a2 2 0 0 1 2 2c0 .74-.4 1.39-1 1.73V7h1a7 7 0 0 1 7 7h1a1 1 0 0 1 1 1v3a1 1 0 0 1-1 1h-1v1a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-1H2a1 1 0 0 1-1-1v-3a1 1 0 0 1 1-1h1a7 7 0 0 1 7-7h1V5.73c-.6-.34-1-.99-1-1.73a2 2 0 0 1 2-2M7.5 13A2.5 2.5 0 0 0 5 15.5 2.5 2.5 0 0 0 7.5 18a2.5 2.5 0 0 0 2.5-2.5A2.5 2.5 0 0 0 7.5 13m9 0a2.5 2.5 0 0 0-2.5 2.5 2.5 2.5 0 0 0 2.5 2.5 2.5 2.5 0 0 0 2.5-2.5 2.5 2.5 0 0 0-2.5-2.5"/></svg>
393
+
394
+ </a>
395
+ RobotLab
396
+ </label>
397
+
398
+ <div class="md-nav__source">
399
+ <a href="https://github.com/madbomber/robot_lab" title="Go to repository" class="md-source" data-md-component="source">
400
+ <div class="md-source__icon md-icon">
401
+
402
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
403
+ </div>
404
+ <div class="md-source__repository">
405
+ madbomber/robot_lab
406
+ </div>
407
+ </a>
408
+ </div>
409
+
410
+ <ul class="md-nav__list" data-md-scrollfix>
411
+
412
+
413
+
414
+
415
+
416
+
417
+
418
+
419
+
420
+
421
+
422
+
423
+
424
+
425
+
426
+
427
+
428
+
429
+
430
+
431
+
432
+
433
+
434
+
435
+
436
+
437
+
438
+
439
+ <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
440
+
441
+
442
+
443
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_1" checked>
444
+
445
+
446
+ <div class="md-nav__link md-nav__container">
447
+ <a href="." class="md-nav__link md-nav__link--active">
448
+
449
+
450
+
451
+ <span class="md-ellipsis">
452
+
453
+
454
+ Home
455
+
456
+
457
+
458
+ </span>
459
+
460
+
461
+
462
+ </a>
463
+
464
+
465
+ <label class="md-nav__link md-nav__link--active" for="__nav_1" id="__nav_1_label" tabindex="">
466
+ <span class="md-nav__icon md-icon"></span>
467
+ </label>
468
+
469
+ </div>
470
+
471
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_1_label" aria-expanded="true">
472
+ <label class="md-nav__title" for="__nav_1">
473
+ <span class="md-nav__icon md-icon"></span>
474
+
475
+
476
+ Home
477
+
478
+
479
+ </label>
480
+ <ul class="md-nav__list" data-md-scrollfix>
481
+
482
+
483
+
484
+
485
+
486
+
487
+
488
+
489
+
490
+ <li class="md-nav__item">
491
+ <a href="concepts/" class="md-nav__link">
492
+
493
+
494
+
495
+ <span class="md-ellipsis">
496
+
497
+
498
+ Concepts
499
+
500
+
501
+
502
+ </span>
503
+
504
+
505
+
506
+ </a>
507
+ </li>
508
+
509
+
510
+
511
+
512
+ </ul>
513
+ </nav>
514
+
515
+ </li>
516
+
517
+
518
+
519
+
520
+
521
+
522
+
523
+
524
+
525
+
526
+
527
+
528
+
529
+
530
+
531
+
532
+
533
+
534
+
535
+
536
+
537
+
538
+
539
+
540
+
541
+
542
+
543
+
544
+
545
+ <li class="md-nav__item md-nav__item--nested">
546
+
547
+
548
+
549
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
550
+
551
+
552
+ <div class="md-nav__link md-nav__container">
553
+ <a href="getting-started/" class="md-nav__link ">
554
+
555
+
556
+
557
+ <span class="md-ellipsis">
558
+
559
+
560
+ Getting Started
561
+
562
+
563
+
564
+ </span>
565
+
566
+
567
+
568
+ </a>
569
+
570
+
571
+ <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="0">
572
+ <span class="md-nav__icon md-icon"></span>
573
+ </label>
574
+
575
+ </div>
576
+
577
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
578
+ <label class="md-nav__title" for="__nav_2">
579
+ <span class="md-nav__icon md-icon"></span>
580
+
581
+
582
+ Getting Started
583
+
584
+
585
+ </label>
586
+ <ul class="md-nav__list" data-md-scrollfix>
587
+
588
+
589
+
590
+
591
+
592
+
593
+
594
+
595
+
596
+ <li class="md-nav__item">
597
+ <a href="getting-started/installation/" class="md-nav__link">
598
+
599
+
600
+
601
+ <span class="md-ellipsis">
602
+
603
+
604
+ Installation
605
+
606
+
607
+
608
+ </span>
609
+
610
+
611
+
612
+ </a>
613
+ </li>
614
+
615
+
616
+
617
+
618
+
619
+
620
+
621
+
622
+
623
+
624
+ <li class="md-nav__item">
625
+ <a href="getting-started/quick-start/" class="md-nav__link">
626
+
627
+
628
+
629
+ <span class="md-ellipsis">
630
+
631
+
632
+ Quick Start
633
+
634
+
635
+
636
+ </span>
637
+
638
+
639
+
640
+ </a>
641
+ </li>
642
+
643
+
644
+
645
+
646
+
647
+
648
+
649
+
650
+
651
+
652
+ <li class="md-nav__item">
653
+ <a href="getting-started/configuration/" class="md-nav__link">
654
+
655
+
656
+
657
+ <span class="md-ellipsis">
658
+
659
+
660
+ Configuration
661
+
662
+
663
+
664
+ </span>
665
+
666
+
667
+
668
+ </a>
669
+ </li>
670
+
671
+
672
+
673
+
674
+ </ul>
675
+ </nav>
676
+
677
+ </li>
678
+
679
+
680
+
681
+
682
+
683
+
684
+
685
+
686
+
687
+
688
+
689
+
690
+
691
+
692
+
693
+
694
+
695
+
696
+
697
+
698
+
699
+
700
+
701
+
702
+
703
+
704
+
705
+
706
+
707
+
708
+
709
+
710
+
711
+ <li class="md-nav__item md-nav__item--nested">
712
+
713
+
714
+
715
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
716
+
717
+
718
+ <div class="md-nav__link md-nav__container">
719
+ <a href="architecture/" class="md-nav__link ">
720
+
721
+
722
+
723
+ <span class="md-ellipsis">
724
+
725
+
726
+ Architecture
727
+
728
+
729
+
730
+ </span>
731
+
732
+
733
+
734
+ </a>
735
+
736
+
737
+ <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="0">
738
+ <span class="md-nav__icon md-icon"></span>
739
+ </label>
740
+
741
+ </div>
742
+
743
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
744
+ <label class="md-nav__title" for="__nav_3">
745
+ <span class="md-nav__icon md-icon"></span>
746
+
747
+
748
+ Architecture
749
+
750
+
751
+ </label>
752
+ <ul class="md-nav__list" data-md-scrollfix>
753
+
754
+
755
+
756
+
757
+
758
+
759
+
760
+
761
+
762
+ <li class="md-nav__item">
763
+ <a href="architecture/core-concepts/" class="md-nav__link">
764
+
765
+
766
+
767
+ <span class="md-ellipsis">
768
+
769
+
770
+ Core Concepts
771
+
772
+
773
+
774
+ </span>
775
+
776
+
777
+
778
+ </a>
779
+ </li>
780
+
781
+
782
+
783
+
784
+
785
+
786
+
787
+
788
+
789
+
790
+ <li class="md-nav__item">
791
+ <a href="architecture/robot-execution/" class="md-nav__link">
792
+
793
+
794
+
795
+ <span class="md-ellipsis">
796
+
797
+
798
+ Robot Execution
799
+
800
+
801
+
802
+ </span>
803
+
804
+
805
+
806
+ </a>
807
+ </li>
808
+
809
+
810
+
811
+
812
+
813
+
814
+
815
+
816
+
817
+
818
+ <li class="md-nav__item">
819
+ <a href="architecture/network-orchestration/" class="md-nav__link">
820
+
821
+
822
+
823
+ <span class="md-ellipsis">
824
+
825
+
826
+ Network Orchestration
827
+
828
+
829
+
830
+ </span>
831
+
832
+
833
+
834
+ </a>
835
+ </li>
836
+
837
+
838
+
839
+
840
+
841
+
842
+
843
+
844
+
845
+
846
+ <li class="md-nav__item">
847
+ <a href="architecture/state-management/" class="md-nav__link">
848
+
849
+
850
+
851
+ <span class="md-ellipsis">
852
+
853
+
854
+ State Management
855
+
856
+
857
+
858
+ </span>
859
+
860
+
861
+
862
+ </a>
863
+ </li>
864
+
865
+
866
+
867
+
868
+
869
+
870
+
871
+
872
+
873
+
874
+ <li class="md-nav__item">
875
+ <a href="architecture/message-flow/" class="md-nav__link">
876
+
877
+
878
+
879
+ <span class="md-ellipsis">
880
+
881
+
882
+ Message Flow
883
+
884
+
885
+
886
+ </span>
887
+
888
+
889
+
890
+ </a>
891
+ </li>
892
+
893
+
894
+
895
+
896
+ </ul>
897
+ </nav>
898
+
899
+ </li>
900
+
901
+
902
+
903
+
904
+
905
+
906
+
907
+
908
+
909
+
910
+
911
+
912
+
913
+
914
+
915
+
916
+
917
+
918
+
919
+
920
+
921
+
922
+
923
+
924
+
925
+
926
+
927
+
928
+
929
+
930
+
931
+
932
+
933
+
934
+
935
+
936
+
937
+ <li class="md-nav__item md-nav__item--nested">
938
+
939
+
940
+
941
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
942
+
943
+
944
+ <div class="md-nav__link md-nav__container">
945
+ <a href="guides/" class="md-nav__link ">
946
+
947
+
948
+
949
+ <span class="md-ellipsis">
950
+
951
+
952
+ Guides
953
+
954
+
955
+
956
+ </span>
957
+
958
+
959
+
960
+ </a>
961
+
962
+
963
+ <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="0">
964
+ <span class="md-nav__icon md-icon"></span>
965
+ </label>
966
+
967
+ </div>
968
+
969
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
970
+ <label class="md-nav__title" for="__nav_4">
971
+ <span class="md-nav__icon md-icon"></span>
972
+
973
+
974
+ Guides
975
+
976
+
977
+ </label>
978
+ <ul class="md-nav__list" data-md-scrollfix>
979
+
980
+
981
+
982
+
983
+
984
+
985
+
986
+
987
+
988
+ <li class="md-nav__item">
989
+ <a href="guides/building-robots/" class="md-nav__link">
990
+
991
+
992
+
993
+ <span class="md-ellipsis">
994
+
995
+
996
+ Building Robots
997
+
998
+
999
+
1000
+ </span>
1001
+
1002
+
1003
+
1004
+ </a>
1005
+ </li>
1006
+
1007
+
1008
+
1009
+
1010
+
1011
+
1012
+
1013
+
1014
+
1015
+
1016
+ <li class="md-nav__item">
1017
+ <a href="guides/creating-networks/" class="md-nav__link">
1018
+
1019
+
1020
+
1021
+ <span class="md-ellipsis">
1022
+
1023
+
1024
+ Creating Networks
1025
+
1026
+
1027
+
1028
+ </span>
1029
+
1030
+
1031
+
1032
+ </a>
1033
+ </li>
1034
+
1035
+
1036
+
1037
+
1038
+
1039
+
1040
+
1041
+
1042
+
1043
+
1044
+ <li class="md-nav__item">
1045
+ <a href="guides/using-tools/" class="md-nav__link">
1046
+
1047
+
1048
+
1049
+ <span class="md-ellipsis">
1050
+
1051
+
1052
+ Using Tools
1053
+
1054
+
1055
+
1056
+ </span>
1057
+
1058
+
1059
+
1060
+ </a>
1061
+ </li>
1062
+
1063
+
1064
+
1065
+
1066
+
1067
+
1068
+
1069
+
1070
+
1071
+
1072
+ <li class="md-nav__item">
1073
+ <a href="guides/mcp-integration/" class="md-nav__link">
1074
+
1075
+
1076
+
1077
+ <span class="md-ellipsis">
1078
+
1079
+
1080
+ MCP Integration
1081
+
1082
+
1083
+
1084
+ </span>
1085
+
1086
+
1087
+
1088
+ </a>
1089
+ </li>
1090
+
1091
+
1092
+
1093
+
1094
+
1095
+
1096
+
1097
+
1098
+
1099
+
1100
+ <li class="md-nav__item">
1101
+ <a href="guides/streaming/" class="md-nav__link">
1102
+
1103
+
1104
+
1105
+ <span class="md-ellipsis">
1106
+
1107
+
1108
+ Streaming Responses
1109
+
1110
+
1111
+
1112
+ </span>
1113
+
1114
+
1115
+
1116
+ </a>
1117
+ </li>
1118
+
1119
+
1120
+
1121
+
1122
+
1123
+
1124
+
1125
+
1126
+
1127
+
1128
+ <li class="md-nav__item">
1129
+ <a href="guides/memory/" class="md-nav__link">
1130
+
1131
+
1132
+
1133
+ <span class="md-ellipsis">
1134
+
1135
+
1136
+ Memory System
1137
+
1138
+
1139
+
1140
+ </span>
1141
+
1142
+
1143
+
1144
+ </a>
1145
+ </li>
1146
+
1147
+
1148
+
1149
+
1150
+
1151
+
1152
+
1153
+
1154
+
1155
+
1156
+ <li class="md-nav__item">
1157
+ <a href="guides/rails-integration/" class="md-nav__link">
1158
+
1159
+
1160
+
1161
+ <span class="md-ellipsis">
1162
+
1163
+
1164
+ Rails Integration
1165
+
1166
+
1167
+
1168
+ </span>
1169
+
1170
+
1171
+
1172
+ </a>
1173
+ </li>
1174
+
1175
+
1176
+
1177
+
1178
+ </ul>
1179
+ </nav>
1180
+
1181
+ </li>
1182
+
1183
+
1184
+
1185
+
1186
+
1187
+
1188
+
1189
+
1190
+
1191
+
1192
+
1193
+
1194
+
1195
+
1196
+
1197
+
1198
+
1199
+
1200
+
1201
+
1202
+
1203
+
1204
+
1205
+
1206
+
1207
+
1208
+
1209
+
1210
+
1211
+
1212
+
1213
+ <li class="md-nav__item md-nav__item--nested">
1214
+
1215
+
1216
+
1217
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
1218
+
1219
+
1220
+ <div class="md-nav__link md-nav__container">
1221
+ <a href="api/" class="md-nav__link ">
1222
+
1223
+
1224
+
1225
+ <span class="md-ellipsis">
1226
+
1227
+
1228
+ API Reference
1229
+
1230
+
1231
+
1232
+ </span>
1233
+
1234
+
1235
+
1236
+ </a>
1237
+
1238
+
1239
+ <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="0">
1240
+ <span class="md-nav__icon md-icon"></span>
1241
+ </label>
1242
+
1243
+ </div>
1244
+
1245
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
1246
+ <label class="md-nav__title" for="__nav_5">
1247
+ <span class="md-nav__icon md-icon"></span>
1248
+
1249
+
1250
+ API Reference
1251
+
1252
+
1253
+ </label>
1254
+ <ul class="md-nav__list" data-md-scrollfix>
1255
+
1256
+
1257
+
1258
+
1259
+
1260
+
1261
+
1262
+
1263
+
1264
+
1265
+
1266
+
1267
+
1268
+
1269
+
1270
+
1271
+
1272
+
1273
+
1274
+
1275
+
1276
+
1277
+
1278
+
1279
+
1280
+
1281
+
1282
+
1283
+
1284
+
1285
+
1286
+
1287
+
1288
+ <li class="md-nav__item md-nav__item--nested">
1289
+
1290
+
1291
+
1292
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
1293
+
1294
+
1295
+ <div class="md-nav__link md-nav__container">
1296
+ <a href="api/core/" class="md-nav__link ">
1297
+
1298
+
1299
+
1300
+ <span class="md-ellipsis">
1301
+
1302
+
1303
+ Core Classes
1304
+
1305
+
1306
+
1307
+ </span>
1308
+
1309
+
1310
+
1311
+ </a>
1312
+
1313
+
1314
+ <label class="md-nav__link " for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
1315
+ <span class="md-nav__icon md-icon"></span>
1316
+ </label>
1317
+
1318
+ </div>
1319
+
1320
+ <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
1321
+ <label class="md-nav__title" for="__nav_5_2">
1322
+ <span class="md-nav__icon md-icon"></span>
1323
+
1324
+
1325
+ Core Classes
1326
+
1327
+
1328
+ </label>
1329
+ <ul class="md-nav__list" data-md-scrollfix>
1330
+
1331
+
1332
+
1333
+
1334
+
1335
+
1336
+
1337
+
1338
+
1339
+ <li class="md-nav__item">
1340
+ <a href="api/core/robot/" class="md-nav__link">
1341
+
1342
+
1343
+
1344
+ <span class="md-ellipsis">
1345
+
1346
+
1347
+ Robot
1348
+
1349
+
1350
+
1351
+ </span>
1352
+
1353
+
1354
+
1355
+ </a>
1356
+ </li>
1357
+
1358
+
1359
+
1360
+
1361
+
1362
+
1363
+
1364
+
1365
+
1366
+
1367
+ <li class="md-nav__item">
1368
+ <a href="api/core/network/" class="md-nav__link">
1369
+
1370
+
1371
+
1372
+ <span class="md-ellipsis">
1373
+
1374
+
1375
+ Network
1376
+
1377
+
1378
+
1379
+ </span>
1380
+
1381
+
1382
+
1383
+ </a>
1384
+ </li>
1385
+
1386
+
1387
+
1388
+
1389
+
1390
+
1391
+
1392
+
1393
+
1394
+
1395
+ <li class="md-nav__item">
1396
+ <a href="api/core/state/" class="md-nav__link">
1397
+
1398
+
1399
+
1400
+ <span class="md-ellipsis">
1401
+
1402
+
1403
+ State
1404
+
1405
+
1406
+
1407
+ </span>
1408
+
1409
+
1410
+
1411
+ </a>
1412
+ </li>
1413
+
1414
+
1415
+
1416
+
1417
+
1418
+
1419
+
1420
+
1421
+
1422
+
1423
+ <li class="md-nav__item">
1424
+ <a href="api/core/tool/" class="md-nav__link">
1425
+
1426
+
1427
+
1428
+ <span class="md-ellipsis">
1429
+
1430
+
1431
+ Tool
1432
+
1433
+
1434
+
1435
+ </span>
1436
+
1437
+
1438
+
1439
+ </a>
1440
+ </li>
1441
+
1442
+
1443
+
1444
+
1445
+
1446
+
1447
+
1448
+
1449
+
1450
+
1451
+ <li class="md-nav__item">
1452
+ <a href="api/core/memory/" class="md-nav__link">
1453
+
1454
+
1455
+
1456
+ <span class="md-ellipsis">
1457
+
1458
+
1459
+ Memory
1460
+
1461
+
1462
+
1463
+ </span>
1464
+
1465
+
1466
+
1467
+ </a>
1468
+ </li>
1469
+
1470
+
1471
+
1472
+
1473
+ </ul>
1474
+ </nav>
1475
+
1476
+ </li>
1477
+
1478
+
1479
+
1480
+
1481
+
1482
+
1483
+
1484
+
1485
+
1486
+
1487
+
1488
+
1489
+
1490
+
1491
+
1492
+
1493
+
1494
+
1495
+
1496
+
1497
+
1498
+
1499
+
1500
+
1501
+
1502
+
1503
+
1504
+
1505
+
1506
+
1507
+
1508
+
1509
+ <li class="md-nav__item md-nav__item--nested">
1510
+
1511
+
1512
+
1513
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
1514
+
1515
+
1516
+ <div class="md-nav__link md-nav__container">
1517
+ <a href="api/messages/" class="md-nav__link ">
1518
+
1519
+
1520
+
1521
+ <span class="md-ellipsis">
1522
+
1523
+
1524
+ Messages
1525
+
1526
+
1527
+
1528
+ </span>
1529
+
1530
+
1531
+
1532
+ </a>
1533
+
1534
+
1535
+ <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
1536
+ <span class="md-nav__icon md-icon"></span>
1537
+ </label>
1538
+
1539
+ </div>
1540
+
1541
+ <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
1542
+ <label class="md-nav__title" for="__nav_5_3">
1543
+ <span class="md-nav__icon md-icon"></span>
1544
+
1545
+
1546
+ Messages
1547
+
1548
+
1549
+ </label>
1550
+ <ul class="md-nav__list" data-md-scrollfix>
1551
+
1552
+
1553
+
1554
+
1555
+
1556
+
1557
+
1558
+
1559
+
1560
+ <li class="md-nav__item">
1561
+ <a href="api/messages/user-message/" class="md-nav__link">
1562
+
1563
+
1564
+
1565
+ <span class="md-ellipsis">
1566
+
1567
+
1568
+ UserMessage
1569
+
1570
+
1571
+
1572
+ </span>
1573
+
1574
+
1575
+
1576
+ </a>
1577
+ </li>
1578
+
1579
+
1580
+
1581
+
1582
+
1583
+
1584
+
1585
+
1586
+
1587
+
1588
+ <li class="md-nav__item">
1589
+ <a href="api/messages/text-message/" class="md-nav__link">
1590
+
1591
+
1592
+
1593
+ <span class="md-ellipsis">
1594
+
1595
+
1596
+ TextMessage
1597
+
1598
+
1599
+
1600
+ </span>
1601
+
1602
+
1603
+
1604
+ </a>
1605
+ </li>
1606
+
1607
+
1608
+
1609
+
1610
+
1611
+
1612
+
1613
+
1614
+
1615
+
1616
+ <li class="md-nav__item">
1617
+ <a href="api/messages/tool-call-message/" class="md-nav__link">
1618
+
1619
+
1620
+
1621
+ <span class="md-ellipsis">
1622
+
1623
+
1624
+ ToolCallMessage
1625
+
1626
+
1627
+
1628
+ </span>
1629
+
1630
+
1631
+
1632
+ </a>
1633
+ </li>
1634
+
1635
+
1636
+
1637
+
1638
+
1639
+
1640
+
1641
+
1642
+
1643
+
1644
+ <li class="md-nav__item">
1645
+ <a href="api/messages/tool-result-message/" class="md-nav__link">
1646
+
1647
+
1648
+
1649
+ <span class="md-ellipsis">
1650
+
1651
+
1652
+ ToolResultMessage
1653
+
1654
+
1655
+
1656
+ </span>
1657
+
1658
+
1659
+
1660
+ </a>
1661
+ </li>
1662
+
1663
+
1664
+
1665
+
1666
+ </ul>
1667
+ </nav>
1668
+
1669
+ </li>
1670
+
1671
+
1672
+
1673
+
1674
+
1675
+
1676
+
1677
+
1678
+
1679
+
1680
+
1681
+
1682
+
1683
+
1684
+
1685
+
1686
+
1687
+
1688
+
1689
+
1690
+
1691
+
1692
+
1693
+
1694
+
1695
+
1696
+
1697
+
1698
+
1699
+
1700
+ <li class="md-nav__item md-nav__item--nested">
1701
+
1702
+
1703
+
1704
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
1705
+
1706
+
1707
+ <div class="md-nav__link md-nav__container">
1708
+ <a href="api/mcp/" class="md-nav__link ">
1709
+
1710
+
1711
+
1712
+ <span class="md-ellipsis">
1713
+
1714
+
1715
+ MCP
1716
+
1717
+
1718
+
1719
+ </span>
1720
+
1721
+
1722
+
1723
+ </a>
1724
+
1725
+
1726
+ <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
1727
+ <span class="md-nav__icon md-icon"></span>
1728
+ </label>
1729
+
1730
+ </div>
1731
+
1732
+ <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
1733
+ <label class="md-nav__title" for="__nav_5_4">
1734
+ <span class="md-nav__icon md-icon"></span>
1735
+
1736
+
1737
+ MCP
1738
+
1739
+
1740
+ </label>
1741
+ <ul class="md-nav__list" data-md-scrollfix>
1742
+
1743
+
1744
+
1745
+
1746
+
1747
+
1748
+
1749
+
1750
+
1751
+ <li class="md-nav__item">
1752
+ <a href="api/mcp/client/" class="md-nav__link">
1753
+
1754
+
1755
+
1756
+ <span class="md-ellipsis">
1757
+
1758
+
1759
+ Client
1760
+
1761
+
1762
+
1763
+ </span>
1764
+
1765
+
1766
+
1767
+ </a>
1768
+ </li>
1769
+
1770
+
1771
+
1772
+
1773
+
1774
+
1775
+
1776
+
1777
+
1778
+
1779
+ <li class="md-nav__item">
1780
+ <a href="api/mcp/server/" class="md-nav__link">
1781
+
1782
+
1783
+
1784
+ <span class="md-ellipsis">
1785
+
1786
+
1787
+ Server
1788
+
1789
+
1790
+
1791
+ </span>
1792
+
1793
+
1794
+
1795
+ </a>
1796
+ </li>
1797
+
1798
+
1799
+
1800
+
1801
+
1802
+
1803
+
1804
+
1805
+
1806
+
1807
+ <li class="md-nav__item">
1808
+ <a href="api/mcp/transports/" class="md-nav__link">
1809
+
1810
+
1811
+
1812
+ <span class="md-ellipsis">
1813
+
1814
+
1815
+ Transports
1816
+
1817
+
1818
+
1819
+ </span>
1820
+
1821
+
1822
+
1823
+ </a>
1824
+ </li>
1825
+
1826
+
1827
+
1828
+
1829
+ </ul>
1830
+ </nav>
1831
+
1832
+ </li>
1833
+
1834
+
1835
+
1836
+
1837
+
1838
+
1839
+
1840
+
1841
+
1842
+
1843
+
1844
+
1845
+
1846
+
1847
+
1848
+
1849
+
1850
+
1851
+
1852
+
1853
+
1854
+
1855
+
1856
+
1857
+
1858
+
1859
+
1860
+
1861
+ <li class="md-nav__item md-nav__item--nested">
1862
+
1863
+
1864
+
1865
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
1866
+
1867
+
1868
+ <div class="md-nav__link md-nav__container">
1869
+ <a href="api/streaming/" class="md-nav__link ">
1870
+
1871
+
1872
+
1873
+ <span class="md-ellipsis">
1874
+
1875
+
1876
+ Streaming
1877
+
1878
+
1879
+
1880
+ </span>
1881
+
1882
+
1883
+
1884
+ </a>
1885
+
1886
+
1887
+ <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
1888
+ <span class="md-nav__icon md-icon"></span>
1889
+ </label>
1890
+
1891
+ </div>
1892
+
1893
+ <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
1894
+ <label class="md-nav__title" for="__nav_5_5">
1895
+ <span class="md-nav__icon md-icon"></span>
1896
+
1897
+
1898
+ Streaming
1899
+
1900
+
1901
+ </label>
1902
+ <ul class="md-nav__list" data-md-scrollfix>
1903
+
1904
+
1905
+
1906
+
1907
+
1908
+
1909
+
1910
+
1911
+
1912
+ <li class="md-nav__item">
1913
+ <a href="api/streaming/context/" class="md-nav__link">
1914
+
1915
+
1916
+
1917
+ <span class="md-ellipsis">
1918
+
1919
+
1920
+ Context
1921
+
1922
+
1923
+
1924
+ </span>
1925
+
1926
+
1927
+
1928
+ </a>
1929
+ </li>
1930
+
1931
+
1932
+
1933
+
1934
+
1935
+
1936
+
1937
+
1938
+
1939
+
1940
+ <li class="md-nav__item">
1941
+ <a href="api/streaming/events/" class="md-nav__link">
1942
+
1943
+
1944
+
1945
+ <span class="md-ellipsis">
1946
+
1947
+
1948
+ Events
1949
+
1950
+
1951
+
1952
+ </span>
1953
+
1954
+
1955
+
1956
+ </a>
1957
+ </li>
1958
+
1959
+
1960
+
1961
+
1962
+ </ul>
1963
+ </nav>
1964
+
1965
+ </li>
1966
+
1967
+
1968
+
1969
+
1970
+ </ul>
1971
+ </nav>
1972
+
1973
+ </li>
1974
+
1975
+
1976
+
1977
+
1978
+
1979
+
1980
+
1981
+
1982
+
1983
+
1984
+
1985
+
1986
+
1987
+
1988
+
1989
+
1990
+
1991
+
1992
+
1993
+
1994
+
1995
+
1996
+
1997
+
1998
+
1999
+
2000
+
2001
+
2002
+
2003
+
2004
+
2005
+
2006
+
2007
+ <li class="md-nav__item md-nav__item--nested">
2008
+
2009
+
2010
+
2011
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
2012
+
2013
+
2014
+ <div class="md-nav__link md-nav__container">
2015
+ <a href="examples/" class="md-nav__link ">
2016
+
2017
+
2018
+
2019
+ <span class="md-ellipsis">
2020
+
2021
+
2022
+ Examples
2023
+
2024
+
2025
+
2026
+ </span>
2027
+
2028
+
2029
+
2030
+ </a>
2031
+
2032
+
2033
+ <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="0">
2034
+ <span class="md-nav__icon md-icon"></span>
2035
+ </label>
2036
+
2037
+ </div>
2038
+
2039
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
2040
+ <label class="md-nav__title" for="__nav_6">
2041
+ <span class="md-nav__icon md-icon"></span>
2042
+
2043
+
2044
+ Examples
2045
+
2046
+
2047
+ </label>
2048
+ <ul class="md-nav__list" data-md-scrollfix>
2049
+
2050
+
2051
+
2052
+
2053
+
2054
+
2055
+
2056
+
2057
+
2058
+ <li class="md-nav__item">
2059
+ <a href="examples/basic-chat/" class="md-nav__link">
2060
+
2061
+
2062
+
2063
+ <span class="md-ellipsis">
2064
+
2065
+
2066
+ Basic Chat
2067
+
2068
+
2069
+
2070
+ </span>
2071
+
2072
+
2073
+
2074
+ </a>
2075
+ </li>
2076
+
2077
+
2078
+
2079
+
2080
+
2081
+
2082
+
2083
+
2084
+
2085
+
2086
+ <li class="md-nav__item">
2087
+ <a href="examples/multi-robot-network/" class="md-nav__link">
2088
+
2089
+
2090
+
2091
+ <span class="md-ellipsis">
2092
+
2093
+
2094
+ Multi-Robot Network
2095
+
2096
+
2097
+
2098
+ </span>
2099
+
2100
+
2101
+
2102
+ </a>
2103
+ </li>
2104
+
2105
+
2106
+
2107
+
2108
+
2109
+
2110
+
2111
+
2112
+
2113
+
2114
+ <li class="md-nav__item">
2115
+ <a href="examples/tool-usage/" class="md-nav__link">
2116
+
2117
+
2118
+
2119
+ <span class="md-ellipsis">
2120
+
2121
+
2122
+ Tool Usage
2123
+
2124
+
2125
+
2126
+ </span>
2127
+
2128
+
2129
+
2130
+ </a>
2131
+ </li>
2132
+
2133
+
2134
+
2135
+
2136
+
2137
+
2138
+
2139
+
2140
+
2141
+
2142
+ <li class="md-nav__item">
2143
+ <a href="examples/mcp-server/" class="md-nav__link">
2144
+
2145
+
2146
+
2147
+ <span class="md-ellipsis">
2148
+
2149
+
2150
+ MCP Server
2151
+
2152
+
2153
+
2154
+ </span>
2155
+
2156
+
2157
+
2158
+ </a>
2159
+ </li>
2160
+
2161
+
2162
+
2163
+
2164
+
2165
+
2166
+
2167
+
2168
+
2169
+
2170
+ <li class="md-nav__item">
2171
+ <a href="examples/rails-application/" class="md-nav__link">
2172
+
2173
+
2174
+
2175
+ <span class="md-ellipsis">
2176
+
2177
+
2178
+ Rails Application
2179
+
2180
+
2181
+
2182
+ </span>
2183
+
2184
+
2185
+
2186
+ </a>
2187
+ </li>
2188
+
2189
+
2190
+
2191
+
2192
+ </ul>
2193
+ </nav>
2194
+
2195
+ </li>
2196
+
2197
+
2198
+
2199
+ </ul>
2200
+ </nav>
2201
+ </div>
2202
+ </div>
2203
+ </div>
2204
+
2205
+
2206
+
2207
+ <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
2208
+ <div class="md-sidebar__scrollwrap">
2209
+ <div class="md-sidebar__inner">
2210
+
2211
+
2212
+
2213
+
2214
+ <nav class="md-nav md-nav--secondary" aria-label="On this page">
2215
+
2216
+
2217
+
2218
+
2219
+
2220
+
2221
+ <label class="md-nav__title" for="__toc">
2222
+ <span class="md-nav__icon md-icon"></span>
2223
+ On this page
2224
+ </label>
2225
+ <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
2226
+
2227
+ <li class="md-nav__item">
2228
+ <a href="#key-features" class="md-nav__link">
2229
+ <span class="md-ellipsis">
2230
+
2231
+ Key Features
2232
+
2233
+ </span>
2234
+ </a>
2235
+
2236
+ </li>
2237
+
2238
+ <li class="md-nav__item">
2239
+ <a href="#quick-example" class="md-nav__link">
2240
+ <span class="md-ellipsis">
2241
+
2242
+ Quick Example
2243
+
2244
+ </span>
2245
+ </a>
2246
+
2247
+ </li>
2248
+
2249
+ <li class="md-nav__item">
2250
+ <a href="#supported-llm-providers" class="md-nav__link">
2251
+ <span class="md-ellipsis">
2252
+
2253
+ Supported LLM Providers
2254
+
2255
+ </span>
2256
+ </a>
2257
+
2258
+ </li>
2259
+
2260
+ <li class="md-nav__item">
2261
+ <a href="#installation" class="md-nav__link">
2262
+ <span class="md-ellipsis">
2263
+
2264
+ Installation
2265
+
2266
+ </span>
2267
+ </a>
2268
+
2269
+ </li>
2270
+
2271
+ <li class="md-nav__item">
2272
+ <a href="#next-steps" class="md-nav__link">
2273
+ <span class="md-ellipsis">
2274
+
2275
+ Next Steps
2276
+
2277
+ </span>
2278
+ </a>
2279
+
2280
+ </li>
2281
+
2282
+ <li class="md-nav__item">
2283
+ <a href="#license" class="md-nav__link">
2284
+ <span class="md-ellipsis">
2285
+
2286
+ License
2287
+
2288
+ </span>
2289
+ </a>
2290
+
2291
+ </li>
2292
+
2293
+ </ul>
2294
+
2295
+ </nav>
2296
+ </div>
2297
+ </div>
2298
+ </div>
2299
+
2300
+
2301
+
2302
+ <div class="md-content" data-md-component="content">
2303
+
2304
+
2305
+
2306
+
2307
+
2308
+
2309
+
2310
+ <article class="md-content__inner md-typeset">
2311
+
2312
+
2313
+
2314
+
2315
+
2316
+ <a href="https://github.com/madbomber/robot_lab/edit/main/docs/index.md" title="Edit this page" class="md-content__button md-icon" rel="edit">
2317
+
2318
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4zm10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1z"/></svg>
2319
+ </a>
2320
+
2321
+
2322
+
2323
+
2324
+
2325
+ <a href="https://github.com/madbomber/robot_lab/raw/main/docs/index.md" title="View source of this page" class="md-content__button md-icon">
2326
+
2327
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 18c.56 0 1 .44 1 1s-.44 1-1 1-1-.44-1-1 .44-1 1-1m0-3c-2.73 0-5.06 1.66-6 4 .94 2.34 3.27 4 6 4s5.06-1.66 6-4c-.94-2.34-3.27-4-6-4m0 6.5a2.5 2.5 0 0 1-2.5-2.5 2.5 2.5 0 0 1 2.5-2.5 2.5 2.5 0 0 1 2.5 2.5 2.5 2.5 0 0 1-2.5 2.5M9.27 20H6V4h7v5h5v4.07c.7.08 1.36.25 2 .49V8l-6-6H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h4.5a8.2 8.2 0 0 1-1.23-2"/></svg>
2328
+ </a>
2329
+
2330
+
2331
+
2332
+ <h1 id="robotlab">RobotLab<a class="headerlink" href="#robotlab" title="Permanent link">&para;</a></h1>
2333
+ <blockquote>
2334
+ <p>[!CAUTION]
2335
+ This gem is under active development. APIs and features may change without notice. See the <a href="https://github.com/MadBomber/robot_lab/blob/main/CHANGELOG.md">CHANGELOG</a> for details.</p>
2336
+ </blockquote>
2337
+ <table>
2338
+ <tr>
2339
+ <td width="50%" align="center" valign="top">
2340
+ <img src="assets/images/robot_lab.jpg" alt="RobotLab"><br>
2341
+ <em>"Build robots. Solve problems."</em>
2342
+ </td>
2343
+ <td width="50%" valign="top">
2344
+ RobotLab is a Ruby gem that enables you to build sophisticated AI applications using multiple specialized robots (LLM agents) that work together to accomplish complex tasks.<br><br>
2345
+ Each robot is backed by a persistent LLM chat, configured with keyword arguments, and run with a simple positional message. Robots can be orchestrated through networks with task-based pipelines, share information through a reactive memory system, and connect to external tools via the Model Context Protocol (MCP).
2346
+ </td>
2347
+ </tr>
2348
+ </table>
2349
+
2350
+ <h2 id="key-features">Key Features<a class="headerlink" href="#key-features" title="Permanent link">&para;</a></h2>
2351
+ <div class="grid cards">
2352
+ <ul>
2353
+ <li>
2354
+ <p><span class="twemoji lg middle"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2a2 2 0 0 1 2 2c0 .74-.4 1.39-1 1.73V7h1a7 7 0 0 1 7 7h1a1 1 0 0 1 1 1v3a1 1 0 0 1-1 1h-1v1a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-1H2a1 1 0 0 1-1-1v-3a1 1 0 0 1 1-1h1a7 7 0 0 1 7-7h1V5.73c-.6-.34-1-.99-1-1.73a2 2 0 0 1 2-2M7.5 13A2.5 2.5 0 0 0 5 15.5 2.5 2.5 0 0 0 7.5 18a2.5 2.5 0 0 0 2.5-2.5A2.5 2.5 0 0 0 7.5 13m9 0a2.5 2.5 0 0 0-2.5 2.5 2.5 2.5 0 0 0 2.5 2.5 2.5 2.5 0 0 0 2.5-2.5 2.5 2.5 0 0 0-2.5-2.5"/></svg></span> <strong>Multi-Robot Architecture</strong></p>
2355
+ <hr />
2356
+ <p>Build applications with multiple specialized AI agents, each inheriting from <code>RubyLLM::Agent</code> with persistent chat and memory.</p>
2357
+ <p><a href="architecture/core-concepts/"><span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13.22 19.03a.75.75 0 0 1 0-1.06L18.19 13H3.75a.75.75 0 0 1 0-1.5h14.44l-4.97-4.97a.749.749 0 0 1 .326-1.275.75.75 0 0 1 .734.215l6.25 6.25a.75.75 0 0 1 0 1.06l-6.25 6.25a.75.75 0 0 1-1.06 0"/></svg></span> Learn more</a></p>
2358
+ </li>
2359
+ <li>
2360
+ <p><span class="twemoji lg middle"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 11h-3.18C14.4 9.84 13.3 9 12 9s-2.4.84-2.82 2H6c-.33 0-2-.1-2-2V8c0-1.83 1.54-2 2-2h10.18C16.6 7.16 17.7 8 19 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3c-1.3 0-2.4.84-2.82 2H6C4.39 4 2 5.06 2 8v1c0 2.94 2.39 4 4 4h3.18c.42 1.16 1.52 2 2.82 2s2.4-.84 2.82-2H18c.33 0 2 .1 2 2v1c0 1.83-1.54 2-2 2H7.82C7.4 16.84 6.3 16 5 16a3 3 0 0 0-3 3 3 3 0 0 0 3 3c1.3 0 2.4-.84 2.82-2H18c1.61 0 4-1.07 4-4v-1c0-2.93-2.39-4-4-4m1-7a1 1 0 0 1 1 1 1 1 0 0 1-1 1 1 1 0 0 1-1-1 1 1 0 0 1 1-1M5 20a1 1 0 0 1-1-1 1 1 0 0 1 1-1 1 1 0 0 1 1 1 1 1 0 0 1-1 1"/></svg></span> <strong>Network Orchestration</strong></p>
2361
+ <hr />
2362
+ <p>Connect robots in task-based pipelines using SimpleFlow with sequential, parallel, and conditional execution.</p>
2363
+ <p><a href="guides/creating-networks/"><span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13.22 19.03a.75.75 0 0 1 0-1.06L18.19 13H3.75a.75.75 0 0 1 0-1.5h14.44l-4.97-4.97a.749.749 0 0 1 .326-1.275.75.75 0 0 1 .734.215l6.25 6.25a.75.75 0 0 1 0 1.06l-6.25 6.25a.75.75 0 0 1-1.06 0"/></svg></span> Creating Networks</a></p>
2364
+ </li>
2365
+ <li>
2366
+ <p><span class="twemoji lg middle"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m21.71 20.29-1.42 1.42a1 1 0 0 1-1.41 0L7 9.85A3.8 3.8 0 0 1 6 10a4 4 0 0 1-3.78-5.3l2.54 2.54.53-.53 1.42-1.42.53-.53L4.7 2.22A4 4 0 0 1 10 6a3.8 3.8 0 0 1-.15 1l11.86 11.88a1 1 0 0 1 0 1.41M2.29 18.88a1 1 0 0 0 0 1.41l1.42 1.42a1 1 0 0 0 1.41 0l5.47-5.46-2.83-2.83M20 2l-4 2v2l-2.17 2.17 2 2L18 8h2l2-4Z"/></svg></span> <strong>Extensible Tools</strong></p>
2367
+ <hr />
2368
+ <p>Give robots tools via <code>RubyLLM::Tool</code> subclasses or <code>RobotLab::Tool.new</code> with block handlers.</p>
2369
+ <p><a href="guides/using-tools/"><span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13.22 19.03a.75.75 0 0 1 0-1.06L18.19 13H3.75a.75.75 0 0 1 0-1.5h14.44l-4.97-4.97a.749.749 0 0 1 .326-1.275.75.75 0 0 1 .734.215l6.25 6.25a.75.75 0 0 1 0 1.06l-6.25 6.25a.75.75 0 0 1-1.06 0"/></svg></span> Using Tools</a></p>
2370
+ </li>
2371
+ <li>
2372
+ <p><span class="twemoji lg middle"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 19h1a1 1 0 0 1 1 1h7v2h-7a1 1 0 0 1-1 1h-4a1 1 0 0 1-1-1H2v-2h7a1 1 0 0 1 1-1h1v-2H4a1 1 0 0 1-1-1v-4a1 1 0 0 1 1-1h16a1 1 0 0 1 1 1v4a1 1 0 0 1-1 1h-7zM4 3h16a1 1 0 0 1 1 1v4a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1m5 4h1V5H9zm0 8h1v-2H9zM5 5v2h2V5zm0 8v2h2v-2z"/></svg></span> <strong>MCP Integration</strong></p>
2373
+ <hr />
2374
+ <p>Connect to Model Context Protocol servers to extend robot capabilities with external tools.</p>
2375
+ <p><a href="guides/mcp-integration/"><span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13.22 19.03a.75.75 0 0 1 0-1.06L18.19 13H3.75a.75.75 0 0 1 0-1.5h14.44l-4.97-4.97a.749.749 0 0 1 .326-1.275.75.75 0 0 1 .734.215l6.25 6.25a.75.75 0 0 1 0 1.06l-6.25 6.25a.75.75 0 0 1-1.06 0"/></svg></span> MCP Guide</a></p>
2376
+ </li>
2377
+ <li>
2378
+ <p><span class="twemoji lg middle"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 2H4c-1.1 0-2 .9-2 2v18l4-4h14c1.1 0 2-.9 2-2V4c0-1.1-.9-2-2-2m0 14H5.2L4 17.2V4h16zM8 9v2h4.5l-1.8 1.8L12 14l4-4-4-4-1.2 1.2L12.5 9z"/></svg></span> <strong>Message Bus</strong></p>
2379
+ <hr />
2380
+ <p>Enable bidirectional, cyclic communication between robots via TypedBus for negotiation loops and convergence patterns.</p>
2381
+ <p><a href="architecture/core-concepts/#message-bus"><span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13.22 19.03a.75.75 0 0 1 0-1.06L18.19 13H3.75a.75.75 0 0 1 0-1.5h14.44l-4.97-4.97a.749.749 0 0 1 .326-1.275.75.75 0 0 1 .734.215l6.25 6.25a.75.75 0 0 1 0 1.06l-6.25 6.25a.75.75 0 0 1-1.06 0"/></svg></span> Message Bus</a></p>
2382
+ </li>
2383
+ <li>
2384
+ <p><span class="twemoji lg middle"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 17H7V7h10m4 4V9h-2V7a2 2 0 0 0-2-2h-2V3h-2v2h-2V3H9v2H7c-1.11 0-2 .89-2 2v2H3v2h2v2H3v2h2v2a2 2 0 0 0 2 2h2v2h2v-2h2v2h2v-2h2a2 2 0 0 0 2-2v-2h2v-2h-2v-2m-6 2h-2v-2h2m2-2H9v6h6z"/></svg></span> <strong>Reactive Memory</strong></p>
2385
+ <hr />
2386
+ <p>Robots share data through a reactive key-value memory system with subscriptions, blocking reads, and optional Redis backend.</p>
2387
+ <p><a href="guides/memory/"><span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13.22 19.03a.75.75 0 0 1 0-1.06L18.19 13H3.75a.75.75 0 0 1 0-1.5h14.44l-4.97-4.97a.749.749 0 0 1 .326-1.275.75.75 0 0 1 .734.215l6.25 6.25a.75.75 0 0 1 0 1.06l-6.25 6.25a.75.75 0 0 1-1.06 0"/></svg></span> Memory System</a></p>
2388
+ </li>
2389
+ </ul>
2390
+ </div>
2391
+ <h2 id="quick-example">Quick Example<a class="headerlink" href="#quick-example" title="Permanent link">&para;</a></h2>
2392
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nb">require</span><span class="w"> </span><span class="s2">&quot;robot_lab&quot;</span>
2393
+ </span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>
2394
+ </span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="c1"># Configuration is automatic via environment variables, YAML files, or defaults.</span>
2395
+ </span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="c1"># Set API keys via env vars:</span>
2396
+ </span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="c1"># ROBOT_LAB_RUBY_LLM__ANTHROPIC_API_KEY=sk-ant-...</span>
2397
+ </span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a><span class="c1">#</span>
2398
+ </span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="c1"># Or place a config file at ~/.config/robot_lab/config.yml</span>
2399
+ </span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="c1"># Access config values: RobotLab.config.ruby_llm.model #=&gt; &quot;claude-sonnet-4&quot;</span>
2400
+ </span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a>
2401
+ </span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="c1"># Create a robot with keyword arguments</span>
2402
+ </span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
2403
+ </span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="w"> </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;assistant&quot;</span><span class="p">,</span>
2404
+ </span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="w"> </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;You are a helpful assistant. Answer questions clearly and concisely.&quot;</span><span class="p">,</span>
2405
+ </span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="w"> </span><span class="ss">model</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;claude-sonnet-4&quot;</span>
2406
+ </span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="p">)</span>
2407
+ </span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a>
2408
+ </span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a><span class="c1"># Run the robot with a positional string argument</span>
2409
+ </span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">robot</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="s2">&quot;What is the capital of France?&quot;</span><span class="p">)</span>
2410
+ </span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a>
2411
+ </span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a><span class="nb">puts</span><span class="w"> </span><span class="n">result</span><span class="o">.</span><span class="n">last_text_content</span>
2412
+ </span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a><span class="c1"># =&gt; &quot;The capital of France is Paris.&quot;</span>
2413
+ </span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a>
2414
+ </span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a><span class="c1"># Memory persists across runs</span>
2415
+ </span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a><span class="n">robot</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="s2">&quot;Remember that my favorite color is blue.&quot;</span><span class="p">)</span>
2416
+ </span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">robot</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="s2">&quot;What is my favorite color?&quot;</span><span class="p">)</span>
2417
+ </span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a><span class="nb">puts</span><span class="w"> </span><span class="n">result</span><span class="o">.</span><span class="n">last_text_content</span>
2418
+ </span><span id="__span-0-27"><a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a><span class="c1"># =&gt; &quot;Your favorite color is blue.&quot;</span>
2419
+ </span><span id="__span-0-28"><a id="__codelineno-0-28" name="__codelineno-0-28" href="#__codelineno-0-28"></a>
2420
+ </span><span id="__span-0-29"><a id="__codelineno-0-29" name="__codelineno-0-29" href="#__codelineno-0-29"></a><span class="c1"># Chaining configuration</span>
2421
+ </span><span id="__span-0-30"><a id="__codelineno-0-30" name="__codelineno-0-30" href="#__codelineno-0-30"></a><span class="n">robot</span><span class="o">.</span><span class="n">with_instructions</span><span class="p">(</span><span class="s2">&quot;Be extra concise.&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">with_temperature</span><span class="p">(</span><span class="mi">0</span><span class="o">.</span><span class="mi">3</span><span class="p">)</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="s2">&quot;Explain Ruby in one sentence.&quot;</span><span class="p">)</span>
2422
+ </span></code></pre></div>
2423
+ <h2 id="supported-llm-providers">Supported LLM Providers<a class="headerlink" href="#supported-llm-providers" title="Permanent link">&para;</a></h2>
2424
+ <p>RobotLab supports multiple LLM providers through the <a href="https://github.com/crmne/ruby_llm">ruby_llm</a> library:</p>
2425
+ <table>
2426
+ <thead>
2427
+ <tr>
2428
+ <th>Provider</th>
2429
+ <th>Models</th>
2430
+ </tr>
2431
+ </thead>
2432
+ <tbody>
2433
+ <tr>
2434
+ <td><strong>Anthropic</strong></td>
2435
+ <td>Claude Opus 4, Claude Sonnet 4, Claude Haiku 3.5</td>
2436
+ </tr>
2437
+ <tr>
2438
+ <td><strong>OpenAI</strong></td>
2439
+ <td>GPT-4o, GPT-4, o1, o3</td>
2440
+ </tr>
2441
+ <tr>
2442
+ <td><strong>Google</strong></td>
2443
+ <td>Gemini 2.5 Pro, Gemini 2.5 Flash</td>
2444
+ </tr>
2445
+ <tr>
2446
+ <td><strong>DeepSeek</strong></td>
2447
+ <td>DeepSeek V3, DeepSeek R1</td>
2448
+ </tr>
2449
+ <tr>
2450
+ <td><strong>AWS Bedrock</strong></td>
2451
+ <td>Claude models via AWS Bedrock</td>
2452
+ </tr>
2453
+ <tr>
2454
+ <td><strong>Google Vertex AI</strong></td>
2455
+ <td>Gemini models via Vertex AI</td>
2456
+ </tr>
2457
+ <tr>
2458
+ <td><strong>Ollama</strong></td>
2459
+ <td>Local models via Ollama</td>
2460
+ </tr>
2461
+ <tr>
2462
+ <td><strong>OpenRouter</strong></td>
2463
+ <td>Multi-provider routing</td>
2464
+ </tr>
2465
+ <tr>
2466
+ <td><strong>Mistral</strong></td>
2467
+ <td>Mistral Large, Mistral Medium</td>
2468
+ </tr>
2469
+ <tr>
2470
+ <td><strong>xAI</strong></td>
2471
+ <td>Grok models</td>
2472
+ </tr>
2473
+ </tbody>
2474
+ </table>
2475
+ <h2 id="installation">Installation<a class="headerlink" href="#installation" title="Permanent link">&para;</a></h2>
2476
+ <p>Add RobotLab to your Gemfile:</p>
2477
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="n">gem</span><span class="w"> </span><span class="s2">&quot;robot_lab&quot;</span>
2478
+ </span></code></pre></div>
2479
+ <p>Or install directly:</p>
2480
+ <div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>gem<span class="w"> </span>install<span class="w"> </span>robot_lab
2481
+ </span></code></pre></div>
2482
+ <p><a href="getting-started/installation/"><span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13.22 19.03a.75.75 0 0 1 0-1.06L18.19 13H3.75a.75.75 0 0 1 0-1.5h14.44l-4.97-4.97a.749.749 0 0 1 .326-1.275.75.75 0 0 1 .734.215l6.25 6.25a.75.75 0 0 1 0 1.06l-6.25 6.25a.75.75 0 0 1-1.06 0"/></svg></span> Full Installation Guide</a></p>
2483
+ <h2 id="next-steps">Next Steps<a class="headerlink" href="#next-steps" title="Permanent link">&para;</a></h2>
2484
+ <div class="grid cards">
2485
+ <ul>
2486
+ <li>
2487
+ <p><a href="getting-started/quick-start/"><span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20.322.75h1.176a1.75 1.75 0 0 1 1.75 1.749v1.177a10.75 10.75 0 0 1-2.925 7.374l-1.228 1.304a24 24 0 0 1-1.596 1.542v5.038c0 .615-.323 1.184-.85 1.5l-4.514 2.709a.75.75 0 0 1-1.12-.488l-.963-4.572a1.3 1.3 0 0 1-.14-.129L8.04 15.96l-1.994-1.873a1.3 1.3 0 0 1-.129-.14l-4.571-.963a.75.75 0 0 1-.49-1.12l2.71-4.514c.316-.527.885-.85 1.5-.85h5.037a24 24 0 0 1 1.542-1.594l1.304-1.23A10.75 10.75 0 0 1 20.321.75Zm-6.344 4.018v-.001l-1.304 1.23a22.3 22.3 0 0 0-3.255 3.851l-2.193 3.29 1.859 1.744.034.034 1.743 1.858 3.288-2.192a22.3 22.3 0 0 0 3.854-3.257l1.228-1.303a9.25 9.25 0 0 0 2.517-6.346V2.5a.25.25 0 0 0-.25-.25h-1.177a9.25 9.25 0 0 0-6.344 2.518M6.5 21c-1.209 1.209-3.901 1.445-4.743 1.49a.24.24 0 0 1-.18-.067.24.24 0 0 1-.067-.18c.045-.842.281-3.534 1.49-4.743.9-.9 2.6-.9 3.5 0s.9 2.6 0 3.5m-.592-8.588L8.17 9.017q.346-.519.717-1.017H5.066a.25.25 0 0 0-.214.121l-2.167 3.612ZM16 15.112q-.5.372-1.018.718l-3.393 2.262.678 3.223 3.612-2.167a.25.25 0 0 0 .121-.214ZM17.5 8a1.5 1.5 0 1 1-3.001-.001A1.5 1.5 0 0 1 17.5 8"/></svg></span> <strong>Quick Start</strong></a></p>
2488
+ <p>Get up and running in 5 minutes</p>
2489
+ </li>
2490
+ <li>
2491
+ <p><a href="concepts/"><span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M0 3.75A.75.75 0 0 1 .75 3h7.497c1.566 0 2.945.8 3.751 2.014A4.5 4.5 0 0 1 15.75 3h7.5a.75.75 0 0 1 .75.75v15.063a.75.75 0 0 1-.755.75l-7.682-.052a3 3 0 0 0-2.142.878l-.89.891a.75.75 0 0 1-1.061 0l-.902-.901a3 3 0 0 0-2.121-.879H.75a.75.75 0 0 1-.75-.75Zm12.75 15.232a4.5 4.5 0 0 1 2.823-.971l6.927.047V4.5h-6.75a3 3 0 0 0-3 3ZM11.247 7.497a3 3 0 0 0-3-2.997H1.5V18h6.947c1.018 0 2.006.346 2.803.98Z"/></svg></span> <strong>Concepts</strong></a></p>
2492
+ <p>Understand the core concepts</p>
2493
+ </li>
2494
+ <li>
2495
+ <p><a href="examples/"><span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M15.22 4.97a.75.75 0 0 1 1.06 0l6.5 6.5a.75.75 0 0 1 0 1.06l-6.5 6.5a.749.749 0 0 1-1.275-.326.75.75 0 0 1 .215-.734L21.19 12l-5.97-5.97a.75.75 0 0 1 0-1.06m-6.44 0a.75.75 0 0 1 0 1.06L2.81 12l5.97 5.97a.749.749 0 0 1-.326 1.275.75.75 0 0 1-.734-.215l-6.5-6.5a.75.75 0 0 1 0-1.06l6.5-6.5a.75.75 0 0 1 1.06 0"/></svg></span> <strong>Examples</strong></a></p>
2496
+ <p>See RobotLab in action</p>
2497
+ </li>
2498
+ <li>
2499
+ <p><a href="api/"><span class="twemoji"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M16 12a4 4 0 1 1-8 0 4 4 0 0 1 8 0m-1.5 0a2.5 2.5 0 1 0-5 0 2.5 2.5 0 0 0 5 0"/><path d="M12 1q.4 0 .797.028c.763.055 1.345.617 1.512 1.304l.352 1.45c.019.078.09.171.225.221q.37.134.728.302c.13.061.246.044.315.002l1.275-.776c.603-.368 1.411-.353 1.99.147q.604.524 1.128 1.129c.501.578.515 1.386.147 1.99l-.776 1.274c-.042.069-.058.185.002.315q.168.357.303.728c.048.135.142.205.22.225l1.45.352c.687.167 1.249.749 1.303 1.512q.057.797 0 1.594c-.054.763-.616 1.345-1.303 1.512l-1.45.352c-.078.019-.171.09-.221.225q-.134.372-.302.728c-.061.13-.044.246-.002.315l.776 1.275c.368.603.353 1.411-.147 1.99q-.524.605-1.129 1.128c-.578.501-1.386.515-1.99.147l-1.274-.776c-.069-.042-.185-.058-.314.002a9 9 0 0 1-.729.303c-.135.048-.205.142-.225.22l-.352 1.45c-.167.687-.749 1.249-1.512 1.303q-.797.057-1.594 0c-.763-.054-1.345-.616-1.512-1.303l-.352-1.45c-.019-.078-.09-.171-.225-.221a8 8 0 0 1-.728-.302c-.13-.061-.246-.044-.315-.002l-1.275.776c-.603.368-1.411.353-1.99-.147q-.605-.524-1.128-1.129c-.501-.578-.515-1.386-.147-1.99l.776-1.274c.042-.069.058-.185-.002-.314a9 9 0 0 1-.303-.729c-.048-.135-.142-.205-.22-.225l-1.45-.352c-.687-.167-1.249-.749-1.304-1.512a11 11 0 0 1 0-1.594c.055-.763.617-1.345 1.304-1.512l1.45-.352c.078-.019.171-.09.221-.225q.134-.372.302-.728c.061-.13.044-.246.002-.315l-.776-1.275c-.368-.603-.353-1.411.147-1.99q.524-.605 1.129-1.128c.578-.501 1.386-.515 1.99-.147l1.274.776c.069.042.185.058.315-.002q.357-.168.728-.303c.135-.048.205-.142.225-.22l.352-1.45c.167-.687.749-1.249 1.512-1.304Q11.598 1 12 1m-.69 1.525c-.055.004-.135.05-.161.161l-.353 1.45a1.83 1.83 0 0 1-1.172 1.277 7 7 0 0 0-.6.249 1.83 1.83 0 0 1-1.734-.074l-1.274-.776c-.098-.06-.186-.036-.228 0a10 10 0 0 0-.976.976c-.036.042-.06.131 0 .228l.776 1.274c.314.529.342 1.18.074 1.734a7 7 0 0 0-.249.6 1.83 1.83 0 0 1-1.278 1.173l-1.45.351c-.11.027-.156.107-.16.162a10 10 0 0 0 0 1.38c.004.055.05.135.161.161l1.45.353a1.83 1.83 0 0 1 1.277 1.172q.111.306.249.6c.268.553.24 1.204-.074 1.733l-.776 1.275c-.06.098-.036.186 0 .228q.453.523.976.976c.042.036.131.06.228 0l1.274-.776a1.83 1.83 0 0 1 1.734-.075q.294.14.6.25a1.83 1.83 0 0 1 1.173 1.278l.351 1.45c.027.11.107.156.162.16a10 10 0 0 0 1.38 0c.055-.004.135-.05.161-.161l.353-1.45a1.83 1.83 0 0 1 1.172-1.278 7 7 0 0 0 .6-.248 1.83 1.83 0 0 1 1.733.074l1.275.776c.098.06.186.036.228 0q.523-.453.976-.976c.036-.042.06-.131 0-.228l-.776-1.275a1.83 1.83 0 0 1-.075-1.733q.14-.294.25-.6a1.83 1.83 0 0 1 1.278-1.173l1.45-.351c.11-.027.156-.107.16-.162a10 10 0 0 0 0-1.38c-.004-.055-.05-.135-.161-.161l-1.45-.353c-.626-.152-1.08-.625-1.278-1.172a7 7 0 0 0-.248-.6 1.83 1.83 0 0 1 .074-1.734l.776-1.274c.06-.098.036-.186 0-.228a10 10 0 0 0-.976-.976c-.042-.036-.131-.06-.228 0l-1.275.776a1.83 1.83 0 0 1-1.733.074 7 7 0 0 0-.6-.249 1.84 1.84 0 0 1-1.173-1.278l-.351-1.45c-.027-.11-.107-.156-.162-.16a10 10 0 0 0-1.38 0"/></svg></span> <strong>API Reference</strong></a></p>
2500
+ <p>Detailed API documentation</p>
2501
+ </li>
2502
+ </ul>
2503
+ </div>
2504
+ <h2 id="license">License<a class="headerlink" href="#license" title="Permanent link">&para;</a></h2>
2505
+ <p>RobotLab is released under the <a href="https://opensource.org/licenses/MIT">MIT License</a>.</p>
2506
+
2507
+
2508
+
2509
+
2510
+
2511
+
2512
+
2513
+
2514
+
2515
+
2516
+
2517
+
2518
+
2519
+ <form class="md-feedback" name="feedback" hidden>
2520
+ <fieldset>
2521
+ <legend class="md-feedback__title">
2522
+ Was this page helpful?
2523
+ </legend>
2524
+ <div class="md-feedback__inner">
2525
+ <div class="md-feedback__list">
2526
+
2527
+ <button class="md-feedback__icon md-icon" type="submit" title="This page was helpful" data-md-value="1">
2528
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 12a8 8 0 0 0-8-8 8 8 0 0 0-8 8 8 8 0 0 0 8 8 8 8 0 0 0 8-8m2 0a10 10 0 0 1-10 10A10 10 0 0 1 2 12 10 10 0 0 1 12 2a10 10 0 0 1 10 10M10 9.5c0 .8-.7 1.5-1.5 1.5S7 10.3 7 9.5 7.7 8 8.5 8s1.5.7 1.5 1.5m7 0c0 .8-.7 1.5-1.5 1.5S14 10.3 14 9.5 14.7 8 15.5 8s1.5.7 1.5 1.5m-5 7.73c-1.75 0-3.29-.73-4.19-1.81L9.23 14c.45.72 1.52 1.23 2.77 1.23s2.32-.51 2.77-1.23l1.42 1.42c-.9 1.08-2.44 1.81-4.19 1.81"/></svg>
2529
+ </button>
2530
+
2531
+ <button class="md-feedback__icon md-icon" type="submit" title="This page could be improved" data-md-value="0">
2532
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 12a8 8 0 0 0-8-8 8 8 0 0 0-8 8 8 8 0 0 0 8 8 8 8 0 0 0 8-8m2 0a10 10 0 0 1-10 10A10 10 0 0 1 2 12 10 10 0 0 1 12 2a10 10 0 0 1 10 10m-6.5-4c.8 0 1.5.7 1.5 1.5s-.7 1.5-1.5 1.5-1.5-.7-1.5-1.5.7-1.5 1.5-1.5M10 9.5c0 .8-.7 1.5-1.5 1.5S7 10.3 7 9.5 7.7 8 8.5 8s1.5.7 1.5 1.5m2 4.5c1.75 0 3.29.72 4.19 1.81l-1.42 1.42C14.32 16.5 13.25 16 12 16s-2.32.5-2.77 1.23l-1.42-1.42C8.71 14.72 10.25 14 12 14"/></svg>
2533
+ </button>
2534
+
2535
+ </div>
2536
+ <div class="md-feedback__note">
2537
+
2538
+ <div data-md-value="1" hidden>
2539
+
2540
+
2541
+
2542
+
2543
+
2544
+
2545
+
2546
+
2547
+
2548
+ Thanks for your feedback!
2549
+ </div>
2550
+
2551
+ <div data-md-value="0" hidden>
2552
+
2553
+
2554
+
2555
+
2556
+
2557
+
2558
+
2559
+
2560
+
2561
+ Thanks for your feedback! Help us improve by creating an issue.
2562
+ </div>
2563
+
2564
+ </div>
2565
+ </div>
2566
+ </fieldset>
2567
+ </form>
2568
+
2569
+
2570
+
2571
+ </article>
2572
+ </div>
2573
+
2574
+
2575
+ <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
2576
+
2577
+ <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
2578
+ </div>
2579
+
2580
+ <button type="button" class="md-top md-icon" data-md-component="top" hidden>
2581
+
2582
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
2583
+ Back to top
2584
+ </button>
2585
+
2586
+ </main>
2587
+
2588
+ <footer class="md-footer">
2589
+
2590
+
2591
+
2592
+ <nav class="md-footer__inner md-grid" aria-label="Footer" >
2593
+
2594
+
2595
+
2596
+ <a href="concepts/" class="md-footer__link md-footer__link--next" aria-label="Next: Concepts">
2597
+ <div class="md-footer__title">
2598
+ <span class="md-footer__direction">
2599
+ Next
2600
+ </span>
2601
+ <div class="md-ellipsis">
2602
+ Concepts
2603
+ </div>
2604
+ </div>
2605
+ <div class="md-footer__button md-icon">
2606
+
2607
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11z"/></svg>
2608
+ </div>
2609
+ </a>
2610
+
2611
+ </nav>
2612
+
2613
+
2614
+ <div class="md-footer-meta md-typeset">
2615
+ <div class="md-footer-meta__inner md-grid">
2616
+ <div class="md-copyright">
2617
+
2618
+ <div class="md-copyright__highlight">
2619
+ Copyright &copy; 2025 Dewayne VanHoozer
2620
+ </div>
2621
+
2622
+
2623
+ Made with
2624
+ <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
2625
+ Material for MkDocs
2626
+ </a>
2627
+
2628
+ </div>
2629
+
2630
+
2631
+ <div class="md-social">
2632
+
2633
+
2634
+
2635
+
2636
+
2637
+ <a href="https://github.com/madbomber/robot_lab" target="_blank" rel="noopener" title="RobotLab on GitHub" class="md-social__link">
2638
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
2639
+ </a>
2640
+
2641
+
2642
+
2643
+
2644
+
2645
+ <a href="https://rubygems.org/gems/robot_lab" target="_blank" rel="noopener" title="RobotLab on RubyGems" class="md-social__link">
2646
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M116.7 33.8c4.5-6.1 11.7-9.8 19.3-9.8h240c7.6 0 14.8 3.6 19.3 9.8l112 152c6.8 9.2 6.1 21.9-1.5 30.4l-232 256c-4.5 5-11 7.9-17.8 7.9s-13.2-2.9-17.8-7.9l-232-256c-7.7-8.5-8.3-21.2-1.5-30.4zm38.5 39.8c-3.3 2.5-4.2 7-2.1 10.5l57.4 95.7L63.3 192c-4.1.3-7.3 3.8-7.3 8s3.2 7.6 7.3 8l192 16h1.3l192-16c4.1-.3 7.3-3.8 7.3-8s-3.2-7.6-7.3-8l-147.2-12.3 57.4-95.6c2.1-3.5 1.2-8.1-2.1-10.5s-7.9-2-10.7 1l-90 97.6-90.1-97.6c-2.8-3-7.4-3.4-10.7-1"/></svg>
2647
+ </a>
2648
+
2649
+ </div>
2650
+
2651
+ </div>
2652
+ </div>
2653
+ </footer>
2654
+
2655
+ </div>
2656
+ <div class="md-dialog" data-md-component="dialog">
2657
+ <div class="md-dialog__inner md-typeset"></div>
2658
+ </div>
2659
+
2660
+
2661
+
2662
+
2663
+
2664
+ <script id="__config" type="application/json">{"annotate": null, "base": ".", "features": ["navigation.instant", "navigation.tracking", "navigation.tabs", "navigation.tabs.sticky", "navigation.path", "navigation.indexes", "navigation.top", "navigation.footer", "toc.follow", "search.suggest", "search.highlight", "search.share", "header.autohide", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.tooltips", "content.action.edit", "content.action.view"], "search": "assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
2665
+
2666
+
2667
+ <script src="assets/javascripts/bundle.79ae519e.min.js"></script>
2668
+
2669
+
2670
+ </body>
2671
+ </html>