> AI agents: this is one page from PostHog's docs. Full index of Markdown docs for LLMs: https://posthog.com/llms.txt # Ruby Experiments installation Canonical URL: https://posthog.com/docs/experiments/installation/ruby > **Cloud region:** This page uses US Cloud hosts. For an EU Cloud project, use `https://eu.i.posthog.com` instead of `https://us.i.posthog.com` (ingestion host). ## On this page - [Install with the wizard](#install-with-the-wizard) - [Install the gem](#install-the-gem) - [Configure PostHog](#configure-posthog) - [Implement your experiment](#implement-your-experiment) - [Run your experiment](#run-your-experiment) - [Next steps](#next-steps) ## Install with the wizard Run this command in your project directory to add PostHog to your Ruby project. The wizard detects your framework, installs the SDK, and sets up your first events. `npx @posthog/wizard` Or set it up manually by following the rest of this guide. 1. 1 ## Install the gem Required Add the PostHog Ruby gem to your Gemfile: Gemfile ```ruby gem "posthog-ruby", "~> 3.0" ``` 2. 2 ## Configure PostHog Required Initialize the PostHog client with your project token and host: Ruby ```ruby require 'posthog' posthog = PostHog::Client.new({ api_key: "", host: "https://us.i.posthog.com", on_error: Proc.new { |status, msg| print msg } }) ``` 3. 3 ## Implement your experiment Required Experiments run on top of our feature flags. You can define which version of your code runs based on the return value of the feature flag: **Note:** Server-side experiment metrics require you to manually send the feature flag information. See [this tutorial](https://posthog.com/docs/experiments/adding-experiment-code.md) for more information. ```ruby experimentFlagValue = posthog.get_feature_flag('your-experiment-feature-flag', 'user distinct id') if experimentFlagValue == 'test' # Do something differently for this user else # It's a good idea to let control variant always be the default behaviour, # so if something goes wrong with flag evaluation, you don't break your app. end ``` 4. 4 ## Run your experiment Required Once you've implemented the feature flag in your code, you'll enable it for a target audience by creating a new experiment in the PostHog dashboard. 5. 5 ## Next steps Recommended Now that you're running experiments, continue with the resources below to learn what else Experiments enables within the PostHog platform. | Resource | Description | | --- | --- | | [Creating an experiment](https://posthog.com/docs/experiments/creating-an-experiment.md) | How to create an experiment in PostHog | | [Adding experiment code](https://posthog.com/docs/experiments/adding-experiment-code.md) | How to implement experiments for all platforms | | [Statistical significance](https://posthog.com/docs/experiments/statistics-bayesian.md) | Understanding when results are meaningful | | [Experiment insights](https://posthog.com/docs/experiments/analyzing-results.md) | How to analyze your experiment data | | [More tutorials](https://posthog.com/docs/experiments/tutorials.md) | Other real-world examples and use cases |