nano-bots 0.0.1 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb32dfa429c178b7af6c3f9a4c8046846ab9ae894c94bbf2038644ceef9c2368
-  data.tar.gz: 21e37c25c085c27f0f0357f8bb878cba2a366641f9d4649dc25536bcd51afc28
+  metadata.gz: ed836839edfabe16e119f3f7e52ad82fbef851885d5adbb5b3097620d0491bfb
+  data.tar.gz: a4f909df92cb62b9d5882ad3c9419e0c4560a15f251fa37aae92814b0e586143
 SHA512:
-  metadata.gz: 0a4a1f1a7f33eb6da088b8418cd0d4da61d8e6890ee8b6a0276330217164966b7266c032eabf3e3454e7879bd5e525b47cc99eff40259b7a1a9f9cf86a72db4f
-  data.tar.gz: 2098e8e5da98da2499ea4267e70be61ba9a06feb5c3fb6375d8ff05dbd01ae72134d34e5205884af80f3c4029c32dc09fec3c91b744ee6f61b05db8a5309b8ec
+  metadata.gz: 2c8f39d6d1b0362fb936b0ee0d3df73a6efb77ee3cb86c17c754f1a129d38c01034c2deff7f37f16143a17c28446fc4ebd868e047aaf616ab298b61d0310fa4e
+  data.tar.gz: 61ec7033e15173f2c74aeb830b48dcfaac676f7be282f3ebede3c198e710c7b92caad92649ddc84b7e3e665de2a74b4417c260aebb63caa0e0d0a3b7cdfb6fa6

data/.gitignore

@@ -1,2 +1,3 @@
 .env
 *.gem
+docker-compose.yml

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    nano-bots (0.0.1)
+    nano-bots (0.0.3)
       babosa (~> 2.0)
       dotenv (~> 2.8, >= 2.8.1)
       faraday (~> 2.7, >= 2.7.4)
@@ -48,7 +48,7 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.12.0)
     rspec-support (3.12.0)
-    rubocop (1.50.2)
+    rubocop (1.51.0)
       json (~> 2.3)
       parallel (~> 1.10)
       parser (>= 3.2.0.0)

data/README.md

@@ -8,10 +8,13 @@ _Image artificially created by Midjourney through a prompt generated by a Nano B
 https://user-images.githubusercontent.com/113217272/237840989-1e29a5cc-6644-48d0-87b4-62798dc6ebd3.mp4
 
 - [Setup](#setup)
+  - [Docker](#docker)
 - [Usage](#usage)
   - [Command Line](#command-line)
   - [Library](#library)
 - [Cartridges](#cartridges)
+- [Providers](#providers)
+- [Debugging](#debugging)
 - [Development](#development)
   - [Publish to RubyGems](#publish-to-rubygems)
 
@@ -20,13 +23,13 @@ https://user-images.githubusercontent.com/113217272/237840989-1e29a5cc-6644-48d0
 For a system usage:
 
 ```sh
-gem install nano-bots -v 0.0.1
+gem install nano-bots -v 0.0.3
 ```
 
 To use it in a project, add it to your `Gemfile`:
 
 ```ruby
-gem 'nano-bots', '~> 0.0.1'
+gem 'nano-bots', '~> 0.0.3'
 ```
 
 ```sh
@@ -40,35 +43,89 @@ export OPENAI_API_ADDRESS=https://api.openai.com
 export OPENAI_API_ACCESS_TOKEN=your-token
 export OPENAI_API_USER_IDENTIFIER=your-user
 
-export NANO_BOTS_STATE_DIRECTORY=/home/user/.local/state/nano-bots
-export NANO_BOTS_CARTRIDGES_DIRECTORY=/home/user/.local/share/nano-bots/cartridges
+# export NANO_BOTS_STATE_DIRECTORY=/home/user/.local/state/nano-bots
+# export NANO_BOTS_CARTRIDGES_DIRECTORY=/home/user/.local/share/nano-bots/cartridges
 ```
 
-Alternatively, if your current directory has a `.env` file with the environment variables, they will be automatically loaded.
+Alternatively, if your current directory has a `.env` file with the environment variables, they will be automatically loaded:
+
+```sh
+OPENAI_API_ADDRESS=https://api.openai.com
+OPENAI_API_ACCESS_TOKEN=your-token
+OPENAI_API_USER_IDENTIFIER=your-user
+
+# NANO_BOTS_STATE_DIRECTORY=/home/user/.local/state/nano-bots
+# NANO_BOTS_CARTRIDGES_DIRECTORY=/home/user/.local/share/nano-bots/cartridges
+```
+
+## Docker
+
+Clone the repository and copy the Docker Compose template:
+
+```
+git clone git@github.com:icebaker/ruby-nano-bots.git
+cd ruby-nano-bots
+cp docker-compose.example.yml docker-compose.yml
+```
+
+Set your provider credentials and choose your desired directory for the cartridges files:
+
+```yaml
+version: '3.7'
+
+services:
+  nano-bots:
+    image: ruby:3.2.2-slim-bullseye
+    command: sh -c "gem install nano-bots -v 0.0.3 && bash"
+    environment:
+      OPENAI_API_ADDRESS: https://api.openai.com
+      OPENAI_API_ACCESS_TOKEN: your-token
+      OPENAI_API_USER_IDENTIFIER: your-user
+    volumes:
+      - ./your-cartridges:/cartridges
+      # - ./your-data:/data
+```
+
+Enter the container:
+```sh
+docker compose run nano-bots
+```
+
+Start playing:
+```sh
+nb - - eval "hello"
+nb - - repl
+
+nb cartridges/assistant.yml - eval "hello"
+nb cartridges/assistant.yml - repl
+```
 
 ## Usage
 
 ### Command Line
 
-After installing the gem, the `rnb` binary command will be available for your project or system.
+After installing the gem, the `nb` binary command will be available for your project or system.
 
 Examples of usage:
 
 ```bash
-rnb to-en-us-translator.yml - eval "Salut, comment ça va?"
+nb - - eval "hello"
+# => Hello! How may I assist you today?
+
+nb to-en-us-translator.yml - eval "Salut, comment ça va?"
 # => Hello, how are you doing?
 
-rnb midjourney.yml - eval "happy and friendly cyberpunk robot"
-# => The robot exploring a bustling city, surrounded by neon lights
-#    and high-rise buildings. The prompt should include colorful
-#    lighting and a sense of excitement in the facial expression.
+nb midjourney.yml - eval "happy cyberpunk robot"
+# => A cheerful and fun-loving robot is dancing wildly amidst a
+#    futuristic and lively cityscape. Holographic advertisements
+#    and vibrant neon colors can be seen in the background.
 
-rnb lisp.yml - eval "(+ 1 2)"
+nb lisp.yml - eval "(+ 1 2)"
 # => 3
 
 cat article.txt |
-  rnb to-en-us-translator.yml - eval |
-  rnb summarizer.yml - eval
+  nb to-en-us-translator.yml - eval |
+  nb summarizer.yml - eval
 # -> LLM stands for Large Language Model, which refers to an
 #    artificial intelligence algorithm capable of processing
 #    and understanding vast amounts of natural language data,
@@ -77,10 +134,31 @@ cat article.txt |
 ```
 
 ```bash
-rnb assistant.yml - repl
+nb - - repl
+
+nb assistant.yml - repl
+```
+
+```text
+🤖> Hi, how are you doing?
+
+As an AI language model, I do not experience emotions but I am functioning
+well. How can I assist you?
+
+🤖> |
 ```
 
-All of the commands above are stateless. If you want to preserve the history of your interactions, replace the `-` with a state key. You can use a simple key, such as your username, or a randomly generated one:
+All of the commands above are stateless. If you want to preserve the history of your interactions, replace the `-` with a state key:
+
+```bash
+nb assistant.yml your-user eval "Salut, comment ça va?"
+nb assistant.yml your-user repl
+
+nb assistant.yml 6ea6c43c42a1c076b1e3c36fa349ac2c eval "Salut, comment ça va?"
+nb assistant.yml 6ea6c43c42a1c076b1e3c36fa349ac2c repl
+```
+
+You can use a simple key, such as your username, or a randomly generated one:
 
 ```ruby
 require 'securerandom'
@@ -88,12 +166,14 @@ require 'securerandom'
 SecureRandom.hex # => 6ea6c43c42a1c076b1e3c36fa349ac2c
 ```
 
-```bash
-rnb assistant.yml your-user eval "Salut, comment ça va?"
-rnb assistant.yml your-user repl
+### Debugging
+
+```sh
+nb - - cartridge
+nb cartridge.yml - cartridge
 
-rnb assistant.yml 6ea6c43c42a1c076b1e3c36fa349ac2c eval "Salut, comment ça va?"
-rnb assistant.yml 6ea6c43c42a1c076b1e3c36fa349ac2c repl
+nb - STATE-KEY state
+nb cartridge.yml STATE-KEY state
 ```
 
 ### Library
@@ -101,13 +181,13 @@ rnb assistant.yml 6ea6c43c42a1c076b1e3c36fa349ac2c repl
 To use it as a library:
 
 ```ruby
-require 'nano-bots/cli' # Equivalent to the `rnb` command.
+require 'nano-bots/cli' # Equivalent to the `nb` command.
 ```
 
 ```ruby
 require 'nano-bots'
 
-NanoBot.cli # Equivalent to the `rnb` command.
+NanoBot.cli # Equivalent to the `nb` command.
 
 NanoBot.repl(cartridge: 'cartridge.yml') # Starts a new REPL.
 
@@ -128,20 +208,15 @@ Here's what a Nano Bot Cartridge looks like:
 
 ```yaml
 ---
-name: Assistant
-version: 0.0.1
+meta:
+  name: Nano Bot Name
+  author: Your Name
+  version: 0.0.1
 
 behaviors:
   interaction:
     directive: You are a helpful assistant.
 
-interfaces:
-  repl:
-    prompt:
-      - text: '🤖'
-      - text: '> '
-        color: blue
-
 provider:
   name: openai
   settings:
@@ -154,6 +229,16 @@ provider:
 
 Check the Nano Bots specification to learn more about [how to build cartridges](https://icebaker.github.io/nano-bots/#/README?id=cartridges).
 
+## Providers
+
+Currently supported providers:
+
+- [ ] [Vicuna](https://github.com/lm-sys/FastChat)
+- [x] [Open AI](https://platform.openai.com/docs/api-reference)
+- [ ] [Google PaLM](https://developers.generativeai.google/)
+- [ ] [Alpaca](https://github.com/tatsu-lab/stanford_alpaca)
+- [ ] [LLaMA](https://github.com/facebookresearch/llama)
+
 ## Development
 
 ```bash
@@ -169,5 +254,5 @@ gem build nano-bots.gemspec
 
 gem signin
 
-gem push nano-bots-0.0.1.gem
+gem push nano-bots-0.0.3.gem
 ```

data/components/providers/openai.rb

@@ -24,6 +24,13 @@ module NanoBot
           )
         end
 
+        def stream(input)
+          provider = @settings.key?(:stream) ? @settings[:stream] : true
+          interface = input[:interface].key?(:stream) ? input[:interface][:stream] : true
+
+          provider && interface
+        end
+
         def evaluate(input, &block)
           messages = input[:history].map do |event|
             { role: event[:who] == 'user' ? 'user' : 'assistant',
@@ -51,7 +58,7 @@ module NanoBot
 
           payload.delete(:logit_bias) if payload.key?(:logit_bias) && payload[:logit_bias].nil?
 
-          if @settings[:stream] && input[:interface][:stream]
+          if stream(input)
             content = ''
 
             payload[:stream] = proc do |chunk, _bytesize|

data/components/storage.rb

@@ -17,8 +17,9 @@ module NanoBot
 
         path = "#{user_home!.sub(%r{/$}, '')}/.local/state/nano-bots" if path.nil?
 
-        path = "#{path.sub(%r{/$}, '')}/nano-bots-rb/#{cartridge[:name].to_slug.normalize}"
-        path = "#{path}/#{cartridge[:version].to_slug.normalize}/#{key.to_slug.normalize}"
+        path = "#{path.sub(%r{/$}, '')}/ruby-nano-bots/#{cartridge[:meta][:author].to_slug.normalize}"
+        path = "#{path}/#{cartridge[:meta][:name].to_slug.normalize}"
+        path = "#{path}/#{cartridge[:meta][:version].to_s.gsub('.', '-').to_slug.normalize}/#{key}"
         path = "#{path}/state.json"
 
         FileUtils.mkdir_p(File.dirname(path))

data/controllers/instance.rb

@@ -6,40 +6,70 @@ require_relative '../logic/helpers/hash'
 require_relative '../components/provider'
 require_relative '../components/storage'
 require_relative './interfaces/repl'
+require_relative './interfaces/eval'
 require_relative './session'
 
 module NanoBot
   module Controllers
     class Instance
-      def initialize(cartridge_path:, state: nil)
+      def initialize(cartridge_path:, stream:, state: nil)
+        @stream = stream
+
         load_cartridge!(cartridge_path)
 
         provider = Components::Provider.new(@cartridge[:provider])
 
-        @session = Session.new(provider:, cartridge: @cartridge, state:)
+        @session = Session.new(provider:, cartridge: @cartridge, state:, stream: @stream)
+      end
+
+      def cartridge
+        puts YAML.dump(@safe_cartridge)
       end
 
-      def debug
-        @session.debug
+      def state
+        @session.state
       end
 
       def eval(input)
-        @session.evaluate_and_print(input, mode: 'eval')
+        Interfaces::Eval.evaluate(input, @cartridge, @session)
+
+        return unless @stream.is_a?(StringIO)
+
+        @stream.flush
+        result = @stream.string.clone
+        @stream.truncate(0)
+        @stream.rewind
+        result
       end
 
       def repl
+        if @stream.is_a?(StringIO)
+          @stream.flush
+          @stream = $stdout
+          @session.stream = @stream
+        end
         Interfaces::REPL.start(@cartridge, @session)
       end
 
       private
 
       def load_cartridge!(path)
-        @cartridge = Logic::Helpers::Hash.symbolize_keys(
-          YAML.safe_load(
-            File.read(Components::Storage.cartridge_path(path)),
-            permitted_classes: [Symbol]
-          )
-        )
+        elected_path = if path.strip == '-'
+                         File.expand_path('../static/cartridges/default.yml', __dir__)
+                       else
+                         Components::Storage.cartridge_path(path)
+                       end
+
+        if elected_path.nil?
+          @stream.write("Cartridge file not found: \"#{path}\"\n")
+          raise StandardError, "Cartridge file not found: \"#{path}\""
+        end
+
+        @cartridge = YAML.safe_load(File.read(elected_path), permitted_classes: [Symbol])
+
+        @safe_cartridge = Marshal.load(Marshal.dump(@cartridge))
+
+        @cartridge = Logic::Helpers::Hash.symbolize_keys(@cartridge)
 
         inject_environment_variables!(@cartridge)
       end

data/controllers/interfaces/cli.rb

@@ -13,20 +13,38 @@ module NanoBot
             puts NanoBot::GEM[:version]
             exit
           when 'help', '', nil
-            puts "Ruby Nano Bots #{NanoBot::GEM[:version]}"
-            puts '  rnb cartridge.yml - eval "Hello"'
-            puts '  rnb cartridge.yml - repl'
-            puts '  rnb cartridge.yml - debug'
-            puts '  rnb cartridge.yml STATE-KEY eval "Hello"'
-            puts '  rnb cartridge.yml STATE-KEY repl'
-            puts '  rnb cartridge.yml STATE-KEY debug'
-            puts '  rnb version'
+            puts ''
+            puts "Nano Bots #{NanoBot::GEM[:version]}"
+            puts ''
+            puts '  nb - - eval "hello"'
+            puts '  nb - - repl'
+            puts ''
+            puts '  nb cartridge.yml - eval "hello"'
+            puts '  nb cartridge.yml - repl'
+            puts ''
+            puts '  nb - STATE-KEY eval "hello"'
+            puts '  nb - STATE-KEY repl'
+            puts ''
+            puts '  nb cartridge.yml STATE-KEY eval "hello"'
+            puts '  nb cartridge.yml STATE-KEY repl'
+            puts ''
+            puts '  nb - - cartridge'
+            puts '  nb cartridge.yml - cartridge'
+            puts ''
+            puts '  nb - STATE-KEY state'
+            puts '  nb cartridge.yml STATE-KEY state'
+            puts ''
+            puts '  nb version'
+            puts '  nb help'
+            puts ''
             exit
           end
 
           params = { cartridge_path: ARGV[0], state: ARGV[1], command: ARGV[2] }
 
-          bot = Instance.new(cartridge_path: params[:cartridge_path], state: params[:state])
+          bot = Instance.new(
+            cartridge_path: params[:cartridge_path], state: params[:state], stream: $stdout
+          )
 
           case params[:command]
           when 'eval'
@@ -35,8 +53,10 @@ module NanoBot
             bot.eval(params[:input])
           when 'repl'
             bot.repl
-          when 'debug'
-            bot.debug
+          when 'state'
+            bot.state
+          when 'cartridge'
+            bot.cartridge
           else
             raise "TODO: [#{params[:command]}]"
           end

data/controllers/interfaces/eval.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'pry'
+require 'rainbow'
+
+require_relative '../../logic/helpers/hash'
+
+module NanoBot
+  module Controllers
+    module Interfaces
+      module Eval
+        def self.evaluate(input, cartridge, session)
+          prefix = build_prefix(cartridge)
+          postfix = build_postfix(cartridge)
+
+          session.print(prefix) unless prefix.nil?
+
+          session.evaluate_and_print(input, mode: 'eval')
+
+          session.print(postfix) unless postfix.nil?
+        end
+
+        def self.build_prefix(cartridge)
+          eval_interface = Logic::Helpers::Hash.fetch(cartridge, %i[interfaces eval])
+          return nil if eval_interface.nil?
+
+          eval_interface[:prefix]
+        end
+
+        def self.build_postfix(cartridge)
+          eval_interface = Logic::Helpers::Hash.fetch(cartridge, %i[interfaces eval])
+          return "\n" if eval_interface.nil? || !eval_interface.key?(:postfix) # default
+
+          eval_interface[:postfix]
+        end
+      end
+    end
+  end
+end

data/controllers/interfaces/repl.rb

@@ -10,20 +10,17 @@ module NanoBot
     module Interfaces
       module REPL
         def self.start(cartridge, session)
-          if Logic::Helpers::Hash.fetch(
-            cartridge, %i[interfaces repl prefix]
-          )
-            session.print(Logic::Helpers::Hash.fetch(cartridge,
-                                                     %i[interfaces repl prefix]))
-          end
-
-          session.boot(mode: 'repl')
-
-          session.print(Logic::Helpers::Hash.fetch(cartridge, %i[interfaces repl postfix]) || "\n")
+          prefix = build_prefix(cartridge)
+          postfix = build_postfix(cartridge)
 
-          session.flush
+          if Logic::Helpers::Hash.fetch(cartridge, %i[behaviors boot instruction])
+            session.print(prefix) unless prefix.nil?
+            session.boot(mode: 'repl')
+            session.print(postfix) unless postfix.nil?
+            session.print("\n")
+          end
 
-          prompt = build_prompt(cartridge[:interfaces][:repl][:prompt])
+          prompt = build_prompt(Logic::Helpers::Hash.fetch(cartridge, %i[interfaces repl prompt]))
 
           Pry.config.prompt = Pry::Prompt.new(
             'REPL',
@@ -32,31 +29,45 @@ module NanoBot
           )
 
           Pry.commands.block_command(/(.*)/, 'handler') do |line|
-            if Logic::Helpers::Hash.fetch(
-              cartridge, %i[interfaces repl prefix]
-            )
-              session.print(Logic::Helpers::Hash.fetch(
-                              cartridge, %i[interfaces repl prefix]
-                            ))
-            end
-
+            session.print(postfix) unless postfix.nil?
             session.evaluate_and_print(line, mode: 'repl')
-            session.print(Logic::Helpers::Hash.fetch(cartridge, %i[interfaces repl postfix]) || "\n")
+            session.print(postfix) unless postfix.nil?
+            session.print("\n")
             session.flush
           end
 
           Pry.start
         end
 
+        def self.build_prefix(cartridge)
+          repl = Logic::Helpers::Hash.fetch(cartridge, %i[interfaces repl])
+          return "\n" if repl.nil? || !repl.key?(:prefix) # default
+
+          repl[:prefix]
+        end
+
+        def self.build_postfix(cartridge)
+          repl = Logic::Helpers::Hash.fetch(cartridge, %i[interfaces repl])
+          return "\n" if repl.nil? || !repl.key?(:postfix) # default
+
+          repl[:postfix]
+        end
+
         def self.build_prompt(prompt)
           result = ''
 
-          prompt.each do |partial|
-            result += if partial[:color]
-                        Rainbow(partial[:text]).send(partial[:color])
-                      else
-                        partial[:text]
-                      end
+          if prompt.is_a?(Array)
+            prompt.each do |partial|
+              result += if partial[:color]
+                          Rainbow(partial[:text]).send(partial[:color])
+                        else
+                          partial[:text]
+                        end
+            end
+          elsif prompt.is_a?(String)
+            result = prompt
+          else
+            result = "🤖#{Rainbow('> ').blue}"
           end
 
           result

data/controllers/session.rb

@@ -12,12 +12,13 @@ module NanoBot
     STREAM_TIMEOUT_IN_SECONDS = 5
 
     class Session
-      def initialize(provider:, cartridge:, state: nil)
+      attr_accessor :stream
+
+      def initialize(provider:, cartridge:, state: nil, stream: $stdout)
+        @stream = stream
         @provider = provider
         @cartridge = cartridge
 
-        @output = $stdout
-
         @stateless = state.nil? || state.strip == '-' || state.strip.empty?
 
         if @stateless
@@ -30,7 +31,7 @@ module NanoBot
         end
       end
 
-      def debug
+      def state
         pp({
              state: {
                path: @state_path,
@@ -67,13 +68,18 @@ module NanoBot
         process(input, mode:)
       end
 
-      def process(input, mode:)
-        streaming = @provider.settings[:stream] && Logic::Helpers::Hash.fetch(
-          @cartridge, [:interfaces, mode.to_sym, :stream]
-        )
+      def streaming(interface)
+        provider = @provider.settings.key?(:stream) ? @provider.settings[:stream] : true
+        interface = interface.key?(:stream) ? interface[:stream] : true
 
+        provider && interface
+      end
+
+      def process(input, mode:)
         interface = Logic::Helpers::Hash.fetch(@cartridge, [:interfaces, mode.to_sym]) || {}
 
+        streaming = streaming(interface)
+
         input[:interface] = interface
 
         updated_at = Time.now
@@ -84,9 +90,6 @@ module NanoBot
           if finished
             @state[:history] << output
             self.print(output[:message]) unless streaming
-            unless Logic::Helpers::Hash.fetch(@cartridge, [:interfaces, mode.to_sym, :postfix]).nil?
-              self.print(Logic::Helpers::Hash.fetch(@cartridge, [:interfaces, mode.to_sym, :postfix]))
-            end
             ready = true
             flush
           elsif streaming
@@ -103,11 +106,11 @@ module NanoBot
       end
 
       def flush
-        @output.flush
+        @stream.flush
       end
 
       def print(content)
-        @output.write(content)
+        @stream.write(content)
       end
     end
   end

data/docker-compose.example.yml

@@ -0,0 +1,13 @@
+version: '3.7'
+
+services:
+  nano-bots:
+    image: ruby:3.2.2-slim-bullseye
+    command: sh -c "gem install nano-bots -v 0.0.3 && bash"
+    environment:
+      OPENAI_API_ADDRESS: https://api.openai.com
+      OPENAI_API_ACCESS_TOKEN: your-token
+      OPENAI_API_USER_IDENTIFIER: your-user
+    volumes:
+      - ./your-cartridges:/cartridges
+      # - ./your-data:/data

data/nano-bots.gemspec

@@ -29,7 +29,7 @@ Gem::Specification.new do |spec|
 
   spec.require_paths = ['ports/dsl']
 
-  spec.executables = ['rnb']
+  spec.executables = ['nb']
 
   spec.add_dependency 'babosa', '~> 2.0'
   spec.add_dependency 'dotenv', '~> 2.8', '>= 2.8.1'

data/ports/dsl/nano-bots.rb

@@ -7,16 +7,16 @@ require_relative '../../controllers/instance'
 require_relative '../../controllers/interfaces/cli'
 
 module NanoBot
-  def self.new(cartridge:, state: '-')
-    Controllers::Instance.new(cartridge_path: cartridge, state:)
+  def self.new(cartridge: '-', state: '-')
+    Controllers::Instance.new(cartridge_path: cartridge, state:, stream: StringIO.new)
   end
 
   def self.cli
     Controllers::Interfaces::CLI.handle!
   end
 
-  def self.repl(cartridge:, state: '-')
-    Controllers::Instance.new(cartridge_path: cartridge, state:).repl
+  def self.repl(cartridge: '-', state: '-')
+    Controllers::Instance.new(cartridge_path: cartridge, state:, stream: $stdout).repl
   end
 
   def self.version

data/static/cartridges/default.yml

@@ -0,0 +1,14 @@
+---
+meta:
+  name: Unknown
+  author: Nobody
+  version: 0.0.0
+
+provider:
+  name: openai
+  settings:
+    model: gpt-3.5-turbo
+    credentials:
+      address: ENV/OPENAI_API_ADDRESS
+      access-token: ENV/OPENAI_API_ACCESS_TOKEN
+      user-identifier: ENV/OPENAI_API_USER_IDENTIFIER

data/static/gem.rb

@@ -3,7 +3,7 @@
 module NanoBot
   GEM = {
     name: 'nano-bots',
-    version: '0.0.1',
+    version: '0.0.3',
     author: 'icebaker',
     summary: 'Ruby Implementation of Nano Bots: small, AI-powered bots',
     description: 'Ruby Implementation of Nano Bots: small, AI-powered bots easily shared as a single file, designed to support multiple providers such as Vicuna, OpenAI ChatGPT, Google PaLM, Alpaca, and LLaMA.',

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nano-bots
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.3
 platform: ruby
 authors:
 - icebaker
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-05-12 00:00:00.000000000 Z
+date: 2023-05-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: babosa
@@ -117,7 +117,7 @@ description: 'Ruby Implementation of Nano Bots: small, AI-powered bots easily sh
   ChatGPT, Google PaLM, Alpaca, and LLaMA.'
 email: 
 executables:
-- rnb
+- nb
 extensions: []
 extra_rdoc_files: []
 files:
@@ -128,19 +128,22 @@ files:
 - Gemfile.lock
 - LICENSE
 - README.md
-- bin/rnb
+- bin/nb
 - components/provider.rb
 - components/providers/base.rb
 - components/providers/openai.rb
 - components/storage.rb
 - controllers/instance.rb
 - controllers/interfaces/cli.rb
+- controllers/interfaces/eval.rb
 - controllers/interfaces/repl.rb
 - controllers/session.rb
+- docker-compose.example.yml
 - logic/helpers/hash.rb
 - nano-bots.gemspec
 - ports/dsl/nano-bots.rb
 - ports/dsl/nano-bots/cli.rb
+- static/cartridges/default.yml
 - static/gem.rb
 homepage: https://github.com/icebaker/ruby-nano-bots
 licenses: