Forest is the back office for operations teams in regulated companies. Ops teams review, decide and act on your data from one interface, or let AI agents do it, within the roles, permissions and audit logs you define.

This repository is the Ruby agent: the part of Forest that runs inside your Rails application, connects to your databases and services, and exposes them to the Forest interface. Your business data never goes through Forest.

# Gemfile
gem 'forest_admin_rails'

bundle install
bundle exec rails generate forest_admin_rails:install <FOREST_ENV_SECRET>

The generator mounts the engine, and creates the initializer and the agent entry point:

# config/initializers/forest_admin_rails.rb
ForestAdminRails.configure do |config|
  config.auth_secret = ENV['FOREST_AUTH_SECRET']
  config.env_secret  = ENV['FOREST_ENV_SECRET']
end

# lib/forest_admin_rails/create_agent.rb
module ForestAdminRails
  class CreateAgent
    def self.setup!
      database_configuration = Rails.configuration.database_configuration
      datasource = ForestAdminDatasourceActiveRecord::Datasource.new(database_configuration[Rails.env])

      @create_agent = ForestAdminAgent::Builder::AgentFactory.instance.add_datasource(datasource)
      customize
      @create_agent.build
    end

    def self.customize
      # Add computed fields, actions, segments and hooks here
    end
  end
end

Environment variables: FOREST_ENV_SECRET, FOREST_AUTH_SECRET, and FOREST_SERVER_URL if you target a dedicated instance. Full guide: docs.forest.app/get-started/quickstart

The agent runs on your infrastructure. The Forest interface calls your agent, and your agent queries your sources: Forest does not store your business data.

forest_admin_rails · forest_admin_agent · forest_admin_rpc_agent · forest_admin_datasource_toolkit · forest_admin_datasource_customizer · forest_admin_datasource_active_record · forest_admin_datasource_mongoid · forest_admin_datasource_snowflake · forest_admin_datasource_zendesk · forest_admin_datasource_graphql_hasura · forest_admin_datasource_mambu_payments · forest_admin_datasource_pylon · forest_admin_datasource_rpc · forest_admin_test_toolkit

A complete demo application lives in packages/_examples/demo.

Bug reports and pull requests are welcome. See CONTRIBUTING.md for setup, tests and commit conventions.

cd packages/<package>
BUNDLE_GEMFILE=Gemfile-test bundle install
BUNDLE_GEMFILE=Gemfile-test bundle exec rspec

Apache 2.0. See LICENSE.