sublayer

sublayer

A model-agnostic Ruby Generative AI DSL and framework. Provides base classes for building Generators, Actions, Tasks, and Agents that can be used to build AI powered applications in Ruby.

Stars: 94

Visit
 screenshot

Sublayer is a model-agnostic Ruby AI Agent framework that provides base classes for building Generators, Actions, Tasks, and Agents to create AI-powered applications in Ruby. It supports various AI models and providers, such as OpenAI, Gemini, and Claude. Generators generate specific outputs, Actions perform operations, Agents are autonomous entities for tasks or monitoring, and Triggers decide when Agents are activated. The framework offers sample Generators and usage examples for building AI applications.

README:

Sublayer

A model-agnostic Ruby AI Agent framework. Provides base classes for building Generators, Actions, Tasks, and Agents that can be used to build AI powered applications in Ruby.

For more detailed documentation visit our documentation site: https://docs.sublayer.com.

Note on Versioning

Pre-1.0 we anticipate many breaking changes to the API. Our current plan is to keep breaking changes to minor, 0.x releases, and patch releases (0.x.y) will be used for new features and bug fixes.

To maintain stability in your application, we recommend pinning the version of Sublayer in your Gemfile to a specific minor version. For example, to pin to version 0.2.x, you would add the following line to your Gemfile:

gem 'sublayer', '~> 0.2'

Notes on 0.2

New default model update: gpt 4 turbo -> gpt 4o

Gemini: Updates include the use of beta API function calling features. Experimental and unstable.

Installation

Install the gem by running the following commands:

$ gem install sublayer

Or add this line to your application's Gemfile:

gem 'sublayer', '~> 0.2'

Choose your AI Model

Sublayer is model-agnostic and can be used with any AI model. Below are the supported LLM Providers. Check out our docs to add your own custom Provider.

OpenAI (Default)

Expects you to have an OpenAI API key set in the OPENAI_API_KEY environment variable.

Visit OpenAI to get an API key.

Usage:

Sublayer.configuration.ai_provider = Sublayer::Providers::OpenAI
Sublayer.configuration.ai_model = "gpt-4o"

Gemini [UNSTABLE]

(Gemini's function calling API is in beta. Not recommended for production use.)

Expects you to have a Gemini API key set in the GEMINI_API_KEY environment variable.

Visit Google AI Studio to get an API key.

Usage:

Sublayer.configuration.ai_provider = Sublayer::Providers::Gemini
Sublayer.configuration.ai_model = "gemini-1.5-pro"

Claude

Expect you to have a Claude API key set in the ANTHROPIC_API_KEY environment variable.

Visit Anthropic to get an API key.

Usage:

Sublayer.configuration.ai_provider = Sublayer::Providers::Claude
Sublayer.configuration.ai_model ="claude-3-5-sonnet-20240620"

Concepts

Generators

Generators are responsible for generating specific outputs based on input data. They focus on a single generation task and do not perform any actions or complex decision-making. Generators are the building blocks of the Sublayer framework.

Examples (in the /spec/generators/examples directory):

Actions

Actions perform specific operations to either get inputs for a Generator or use the generated output from a Generator. Actions do not involve complex decision making.

Examples:

Agents

Sublayer Agents are autonomous entities designed to perform specific tasks or monitor systems.

Examples:

  • RSpecAgent: Runs tests whenever a file is changed. If the tests fail the code is changed by the agent to pass the tests.

Triggers

Sublayer Triggers are used in agents. Triggers decide when an agent is activated and performs its task

Examples:

  • FileChange: This built in sublayer trigger, listens for file changes
  • TimeInterval This custom trigger tutorial shows how to create your own trigger, this one activates on a time interval

Usage Examples

There are sample Generators in the /examples/ directory that demonstrate how to build generators using the Sublayer framework. Alternatively below are links to open source projects that are using generators in different ways:

  • Blueprints - An open source AI code assistant that allows you to capture patterns in your codebase to use as a base for generating new code.

  • Clag - A ruby gem that generates command line commands from a simple description right in your terminal.

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for sublayer

Similar Open Source Tools

For similar tasks

For similar jobs