Gromit

Your documentation search assitant

Usage

Make sure to provide your OpenAI token using the OPENAPI_ACCESS_TOKEN environment variable.

To mount the Gromit engine in Rails 7, require the engine from your Gemfile:

gem "gromit", require: "gromit/engine"

And add this line to your routes:

Rails.application.routes.draw do
  mount Gromit::Engine => "/"
end

Gromit provides the following routes:

Routes for Gromit::Engine:
healthcheck GET  /healthcheck(.:format) gromit/gromit#healthcheck {:format=>:json}
     search POST /search(.:format)      gromit/gromit#search {:format=>:json}
     upsert POST /upsert(.:format)      gromit/gromit#upsert {:format=>:json}

To index your documentation locally you can use gromit-reindexer. This will update redis-stack-server running on your machine.

bundle exec gromit-reindexer -s /path/to/your/docs

To remotely upsert your documentation you can use gromit-uploader.

BASE_URL=https://gromit-rails.example.com bundle exec gromit-uploader -s /path/to/your/docs

For a working example of a Rails 7 application using Gromit check out: https://github.com/releasehub-com/gromit-example

Installation

Add this line to your application's Gemfile:

gem "gromit"

And then execute:

$ bundle

Or install it yourself as:

$ gem install gromit

Contributing

Contribution directions go here.

License

The gem is available as open source under the terms of the MIT License.


Made with love by the folks @ release.com