https://github.com/Flagsmith/flagsmith
Open Source Feature Flagging and Remote Config Service. Host on-prem or use our hosted version at https://flagsmith.com/
https://github.com/Flagsmith/flagsmith
cd ci continuous-integration docker feature-flag feature-flaggers feature-flagging feature-flags feature-management feature-toggles flagsmith hacktoberfest multivariate-testing python react remote-config remote-control self-hosted
Last synced: about 1 month ago
JSON representation
Open Source Feature Flagging and Remote Config Service. Host on-prem or use our hosted version at https://flagsmith.com/
- Host: GitHub
- URL: https://github.com/Flagsmith/flagsmith
- Owner: Flagsmith
- License: bsd-3-clause
- Created: 2018-06-05T10:49:57.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2024-10-29T10:30:39.000Z (6 months ago)
- Last Synced: 2024-10-29T10:55:53.278Z (6 months ago)
- Topics: cd, ci, continuous-integration, docker, feature-flag, feature-flaggers, feature-flagging, feature-flags, feature-management, feature-toggles, flagsmith, hacktoberfest, multivariate-testing, python, react, remote-config, remote-control, self-hosted
- Language: Python
- Homepage: https://flagsmith.com/
- Size: 65.8 MB
- Stars: 4,825
- Watchers: 35
- Forks: 368
- Open Issues: 331
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Codeowners: CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
- awesome - Flagsmith/flagsmith - Flagsmith is an open source feature flagging and remote config service. Self-host, or use our SaaS at https://app.flagsmith.com. (Python)
- jimsghstars - Flagsmith/flagsmith - Open Source Feature Flagging and Remote Config Service. Host on-prem or use our hosted version at https://flagsmith.com/ (Python)
- awesome - Flagsmith - Open Source Feature Flagging and Remote Config Service (Architecture / Feature Flags)
- awesome - Flagsmith/flagsmith - Flagsmith is an open source feature flagging and remote config service. Self-host, or use our SaaS at https://app.flagsmith.com. (Python)
- awesome-list - flagsmith
- awesome-django - Flagsmith - Open-source Feature Flagging, Remote Config, and AB testing. (Projects / Open Source Projects)
- awesome-starred - Flagsmith/flagsmith - Open Source Feature Flagging and Remote Config Service. Host on-prem or use our hosted version at https://flagsmith.com/ (docker)
- awesome-homelab - Flagsmith - host, or use our SaaS at https://app.flagsmith.com. | (Apps / X)
README
[](https://www.flagsmith.com/)
[](https://github.com/Flagsmith/flagsmith/stargazers)
[](https://hub.docker.com/u/flagsmith)
[](https://hub.docker.com/r/flagsmith/flagsmith)
[](https://discord.gg/hFhxNtXzgm)
[](https://codecov.io/gh/Flagsmith/flagsmith)
[Flagsmith](https://flagsmith.com/) is an open source, fully featured, Feature Flag and Remote Config service. Use our
hosted API, deploy to your own private cloud, or run on-premise.
# Flagsmith
Flagsmith makes it easy to create and manage features flags across web, mobile, and server side applications. Just wrap
a section of code with a flag, and then use Flagsmith to toggle that feature on or off for different environments, users
or user segments.
Get up and running in less than a minute:
```bash
curl -o docker-compose.yml https://raw.githubusercontent.com/Flagsmith/flagsmith/main/docker-compose.yml
docker-compose -f docker-compose.yml up
```
The application will bootstrap an admin user, organisation, and project for you. You'll find a link to set your password
in your Compose logs:
```txt
Superuser "[email protected]" created successfully.
Please go to the following page and choose a password: http://localhost:8000/password-reset/confirm/.../...
```
Note: This setup uses http:// for local development. If you've configured SSL for your local environment, you may use
https:// instead. For any production deployment, always use https://.
## Features
- **Feature flags**. Release features with confidence through phased roll-outs.
- **Remote config**. Easily toggle individual features on and off, and make changes without deploying new code.
- **A/B and Multivariate Testing**. Use segments to run A/B and multivariate tests on new features. With segments, you
can also introduce beta programs to get early user feedback.
- **Organization Management**. Organizations, projects, and roles for team members help keep your deployment organized.
- **Integrations**. Easily enhance Flagsmith with your favourite tools.
## Trying Flagsmith
### Flagsmith hosted SaaS
You can try our hosted version for free at https://flagsmith.com/
### Flagsmith Open Source
The Flagsmith API is built using Python 3, Django 4, and DjangoRestFramework 3. You can try the application out using:
- [Docker](https://github.com/Flagsmith/flagsmith/blob/main/docker-compose.yml)
- [Kubernetes](https://github.com/Flagsmith/flagsmith-charts)
- [Redhat OpenShift](https://operatorhub.io/operator/flagsmith)
We also have options for deploying to AWS, GCP, Azure and On-Premise. If you need help getting up and running, please
[get in touch!](mailto:[email protected])
## Overview
This repository is formed of 2 core components, the REST API (found in `/api`) and the web-based administrator dashboard
(found in `/frontend`) that you can use to manage Flagsmith. Technical documentation for each component can be found at
the [API](https://docs.flagsmith.com/deployment/locally-api) and
[Frontend](https://docs.flagsmith.com/deployment/locally-frontend) pages within our
[Documentation](https://docs.flagsmith.com/)
These two components run as separate applications. The web-based dashboard is a single page app that communicates via
REST calls to the API.
## Resources
- [Website](https://flagsmith.com/)
- [Documentation](https://docs.flagsmith.com/)
- If you have any questions about our projects you can email [[email protected]](mailto:[email protected])
## Acknowledgements
Thank you to [Uffizzi](https://www.uffizzi.com) for providing ephemeral environments to preview pull requests.
