Repo brief: splitrb/split

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T12:37:54.646Z · commit fa42fc0eeebd

Verdict

Mixed — Single-maintainer risk — review before adopting

• Last commit today
• 8 active contributors
• MIT licensed
• CI configured
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

Split is a Rack-based A/B testing framework that enables controlled experiments across Rails, Sinatra, and other Rack applications. It uses Redis to persist experiment state and user assignments, allowing developers to run multivariate tests and track conversion metrics with minimal application code changes. Core library structure: lib/split/experiment.rb and lib/split/trial.rb model test state; lib/split/helper.rb provides Rails/Sinatra integration helpers; lib/split/persistence/ contains pluggable storage adapters; lib/split/dashboard/ provides a web UI for experiment management. Algorithms in lib/split/algorithms/ (whiplash, weighted_sample, block_randomization) handle assignment logic.

Start here

Open these first:

• lib/split.rb — Main entry point and primary namespace for the Split gem; sets up configuration and exposes core API
• lib/split/experiment.rb — Core experiment abstraction that manages trial creation, participant assignment, and result tracking
• lib/split/helper.rb — Rails view helpers for running experiments and tracking conversions in application views
• lib/split/persistence — Adapter layer supporting multiple backends (Redis, cookies, sessions) for storing participant state
• lib/split/algorithms — Randomization and weighting strategies (block randomization, weighted sample, whiplash) for experiment assignment

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

Clone the repository: git clone https://github.com/splitrb/split.git && cd split. Install dependencies: bundle install (Gemfile is present). Verify Redis is running on localhost:6379 (per README requirements). Run t…

Daily commands:

No traditional 'dev server' for Split itself (it's a library, not an app). To test the gem: bundle exec rake runs the test suite (Rakefile present). To use in a Rails app: add gem 'split' to Gemfile, run `bundle ins…

…shortened for this brief.

Key cautions & unknowns

• Single-maintainer risk — top contributor 88% of recent commits
• Scorecard: default branch unprotected (0/10)
• Redis required and must be running before the app starts; configuration via Split.redis= or config block, no fallback to in-memory store. Persistence adapter selection is global; mixing Redis and session…
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests
• OpenSSF Scorecard

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.