16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
|
# File 'lib/legate/cli/skaffold_commands.rb', line 16
def generate(project_name = nil)
target_dir = options[:dir] || project_name || '.'
target_dir = File.expand_path(target_dir)
say "Skaffolding new Legate project in '#{target_dir}'...", :green
unless Dir.exist?(target_dir)
FileUtils.mkdir_p(target_dir)
say "Created directory: #{target_dir}", :cyan
end
create_file(File.join(target_dir, 'Gemfile'), <<~GEMFILE)
source 'https://rubygems.org'
gem 'legate'
gem 'dotenv' # For loading .env files
gem 'puma' # App server for the Web UI
group :test do
gem 'rspec'
end
GEMFILE
create_file(File.join(target_dir, 'config.ru'), <<~CONFIGRU)
# frozen_string_literal: true
require 'rubygems'
require 'bundler/setup'
# Load environment variables early
require 'dotenv/load' if File.exist?('.env')
require 'legate'
# Configure Legate
Legate.configure do |config|
# Set your global configuration here
# config.default_model_name = 'gemini-3.5-flash'
#{' '}
# config.session_service = Legate::SessionService::InMemory.new
end
# Helper to recursively require files in specific directories
def recursive_require(base_dir, sub_dirs)
sub_dirs.each do |dir|
full_path = File.join(base_dir, dir)
next unless Dir.exist?(full_path)
Dir.glob(File.join(full_path, '**', '*.rb')).sort.each do |file|
# Skip tests/specs and tools inside agent directories if loading agents
next if file.include?('_spec.rb') || file.include?('_test.rb')
next if dir.include?('agents') && file.include?('/tools/')
begin
require file
rescue LoadError => e
puts "WARN: Failed to load \#{file}: \#{e.message}"
end
end
end
end
# Load Agents
recursive_require(__dir__, ['lib/agents', 'agents/lib/agents', 'agents'])
# Load Tools
recursive_require(__dir__, ['lib/tools', 'agents/lib/tools', 'tools'])
# Check for Legate configuration for webhooks
if Legate.config.respond_to?(:webhooks) && Legate.config.webhooks.listener_enabled
require 'legate/web/webhook_listener'
# Mount the webhook listener if enabled
map Legate.config.webhooks.base_path do
run Legate::Web::WebhookListener.new
end
end
# Run the Legate Web UI
require 'legate/web/app'
run Legate::Web::App.new
CONFIGRU
agents_dir = File.join(target_dir, 'agents')
FileUtils.mkdir_p(agents_dir)
create_file(File.join(agents_dir, 'hello_world_agent.rb'), <<~RUBY)
require 'legate'
Legate::Agent.define do |a|
a.name :hello_world
a.description "A friendly agent that helps you verify your setup."
a.instruction "You are a helpful assistant. When asked to say hello, you should reply enthusiastically."
#{' '}
# Use built-in tools
a.use_tool :echo#{' '}
a.use_tool :sample_tool
#{' '}
# a.model_name 'gemini-1.5-pro'
end
RUBY
create_file(File.join(agents_dir, 'research_assistant_agent.rb'), <<~RUBY)
require 'legate'
# A research assistant that can look things up on the web and reason about
# what it finds. It uses Legate's built-in, SSRF-safe HTTP tools — no extra
# setup required beyond a GOOGLE_API_KEY for the LLM.
Legate::Agent.define do |a|
a.name :research_assistant
a.description "Researches a question by fetching and reading web pages, then summarizes the findings."
a.instruction <<~INSTRUCTION
You are a thorough research assistant.
When given a question or topic:
1. Use read_webpage to fetch and read relevant pages the user provides
or that you can construct URLs for (e.g. documentation or APIs).
2. Use http_request when you need a raw API response (JSON, status checks).
3. Use current_time when the answer depends on today's date.
Always cite the URLs you read, distinguish facts from inference, and say
clearly when a source could not be reached or did not answer the question.
INSTRUCTION
a.use_tool :read_webpage
a.use_tool :http_request
a.use_tool :current_time
# a.model_name 'gemini-1.5-pro'
end
RUBY
tools_dir = File.join(target_dir, 'tools')
FileUtils.mkdir_p(tools_dir)
create_file(File.join(tools_dir, '.keep'), '')
create_file(File.join(tools_dir, 'sample_tool.rb'), <<~RUBY)
require 'legate/tool'
class SampleTool < Legate::Tool
tool_description "Greets a user by name."
#{' '}
parameter :name,#{' '}
type: :string,#{' '}
description: "The name of the user to greet",#{' '}
required: true
private
def perform_execution(params, _context)
name = params[:name] || params['name']
{ status: :success, result: "Hello, \#{name}! This is a custom tool." }
end
end
Legate::GlobalToolManager.register_tool(SampleTool)
RUBY
create_file(File.join(target_dir, '.env.example'), <<~ENV)
# Copy this to .env and set your values
GOOGLE_API_KEY=your_api_key_here
LEGATE_LOG_LEVEL=INFO
ENV
bin_dir = File.join(target_dir, 'bin')
FileUtils.mkdir_p(bin_dir)
console_path = File.join(bin_dir, 'console')
create_file(console_path, <<~RUBY)
#!/usr/bin/env ruby
require 'bundler/setup'
require 'irb'
require 'dotenv/load'
require 'legate'
# Load agents/tools
Dir[File.join(__dir__, '..', 'agents', '*.rb')].each { |file| require file }
Dir[File.join(__dir__, '..', 'tools', '*.rb')].each { |file| require file }
puts "Legate Console loaded."
IRB.start
RUBY
FileUtils.chmod(0o755, console_path)
say "\nSkaffolding complete!", :green
say 'Next steps:', :yellow
say " 1. cd #{target_dir}", :cyan
say ' 2. cp .env.example .env (and configure it)', :cyan
say ' 3. bundle install', :cyan
say ' 4. bundle exec rackup (to start the Web UI)', :cyan
end
|