Prompt Manager

A Ruby on Rails application for creating, managing, and executing prompts with language models (LLMs). Built with modern Rails conventions, Hotwire for dynamic interactions, and Tailwind CSS for styling.

Features

• Prompt Management: Create, edit, and organize prompts with variable support
• LLM Integration: Execute prompts with multiple AI providers (OpenAI, Anthropic)
• Generation History: Track and view all prompt executions and results
• Modern UI: Responsive interface built with Hotwire and Tailwind CSS
• Docker Support: Containerized deployment ready
• Basic Authentication: HTTP Basic Auth protection for the entire application

Technology Stack

• Backend: Ruby on Rails 7.2+
• Database: PostgreSQL with UUID primary keys
• Frontend: Hotwire (Turbo + Stimulus), Tailwind CSS
• JavaScript: Importmap-based (no bundler required)
• Deployment: Docker containerization
• Authentication: HTTP Basic Authentication

Prerequisites

• Ruby 3.1.4+
• PostgreSQL 9.3+
• Node.js (for Tailwind CSS compilation)

Installation

1. Install dependencies

bundle install

2. Environment configuration

Create a .env file in the root directory with the following variables:

# Basic Authentication Credentials
BASIC_AUTH_USERNAME=admin
BASIC_AUTH_PASSWORD=your_secure_password_here

# Add your other API keys here

Important: Replace your_secure_password_here with a strong password. The .env file is already in .gitignore to keep your credentials secure.

3. Database setup

# Create and setup database
bin/rails db:create
bin/rails db:migrate
bin/rails db:seed

4. Start the development server

bin/dev

The application will be available at http://localhost:3000

Basic Authentication

This application is protected with HTTP Basic Authentication. When you first visit the application, you'll be prompted for credentials:

• Username: Set via BASIC_AUTH_USERNAME environment variable (defaults to "admin")
• Password: Set via BASIC_AUTH_PASSWORD environment variable (defaults to "password")

To change the credentials:

1. Update the values in your .env file
2. Restart the Rails server

For production deployment, make sure to set strong, unique credentials using environment variables.

Development

Running the application

# Start the development server with hot reloading
bin/dev

# Or start components individually
bin/rails server
bin/rails tailwindcss:watch

Background Jobs

This application uses different background job systems for different environments:

Development: Uses Sucker Punch (in-process, no additional setup required)

• Jobs run in the same process as the web server
• No Redis or additional services needed
• Perfect for development and testing

Production: Uses Sidekiq (requires Redis)

• Jobs run in separate worker processes
• Requires Redis server running
• Better for production workloads

To run in production:

# Start Redis
redis-server

# Start Sidekiq workers
bundle exec sidekiq

# Start Rails server
rails server

Key Models

• Prompt: Stores prompt templates with variable placeholders
• Generation: Records prompt executions and LLM responses

API Integration

The application integrates with multiple LLM providers through service objects:

• AnthropicService: Claude API integration
• LlmService: Generic LLM service interface

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For support and questions, please open an issue in the repository.