{"id":15010672,"url":"https://github.com/taoensso/touchstone","last_synced_at":"2025-12-12T01:20:23.167Z","repository":{"id":5294002,"uuid":"6474765","full_name":"taoensso/touchstone","owner":"taoensso","description":"Simple A/B testing library for Clojure","archived":false,"fork":false,"pushed_at":"2024-03-19T14:25:18.000Z","size":243,"stargazers_count":139,"open_issues_count":1,"forks_count":5,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-07-06T23:16:02.337Z","etag":null,"topics":["clojure","engagement-testing","epl","multi-armed-bandit","split-testing","taoensso"],"latest_commit_sha":null,"homepage":"https://www.taoensso.com/touchstone","language":"Clojure","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/taoensso.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":"FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"ptaoussanis","custom":"https://www.taoensso.com/clojure"}},"created_at":"2012-10-31T13:59:17.000Z","updated_at":"2025-06-05T18:07:54.000Z","dependencies_parsed_at":"2023-01-13T13:25:34.459Z","dependency_job_id":"87fcf91f-8e05-4199-aa27-cbe28106fb0b","html_url":"https://github.com/taoensso/touchstone","commit_stats":null,"previous_names":["taoensso/touchstone","ptaoussanis/touchstone"],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/taoensso/touchstone","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taoensso%2Ftouchstone","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taoensso%2Ftouchstone/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taoensso%2Ftouchstone/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taoensso%2Ftouchstone/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/taoensso","download_url":"https://codeload.github.com/taoensso/touchstone/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/taoensso%2Ftouchstone/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265436728,"owners_count":23765016,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clojure","engagement-testing","epl","multi-armed-bandit","split-testing","taoensso"],"created_at":"2024-09-24T19:35:17.708Z","updated_at":"2025-12-12T01:20:23.128Z","avatar_url":"https://github.com/taoensso.png","language":"Clojure","funding_links":["https://github.com/sponsors/ptaoussanis","https://www.taoensso.com/clojure"],"categories":[],"sub_categories":[],"readme":"\u003ca href=\"https://www.taoensso.com\" title=\"More stuff by @ptaoussanis at www.taoensso.com\"\u003e\n\u003cimg src=\"https://www.taoensso.com/taoensso-open-source.png\" alt=\"Taoensso open-source\" width=\"350\"/\u003e\u003c/a\u003e\n\n**[CHANGELOG][]** | [API][] | current [Break Version][]:\n\n```clojure\n[com.taoensso/touchstone \"2.0.2\"] ; Mature/stable (basically \"done\")\n```\n\n\u003e See [here][backers] if to help support my open-source work, thanks! - [Peter Taoussanis][Taoensso.com]\n\n# Touchstone\n\n### Simple A/B testing library for Clojure\n\n[A/B testing][] is great for **conversion optimization**. We should all be doing more of it. But traditional A/B tests can be a nuisance to setup and monitor.\n\nTouchstone is an attempt to bring **dead-simple, high-power split-testing** to any Clojure web application. It uses [multi-armed bandit][] techniques to provide **fast, accurate, low-maintenance** conversion optimization. The API is simple and *highly flexible*.\n\n## Library status\n\n**Last updated**: Jan 2016\n\nHaven't updated the lib in forever, but it's **stable and works well in production**. Do have some new stuff planned for a future update (particularly docs re: use with modern Cljs applications), but no ETA on that yet.\n\n\\- [Peter Taoussanis][Taoensso.com]\n\n## Features\n * Tiny, **simple API**\n * **Great performance** backed by Redis and [Carmine][]\n * **High flexibility** (variations are *arbitrary Clojure forms*)\n * **Low maintenace** (fire-and-forget, automatic-selection algorithm)\n * Fire-and-forget **multivariate** testing\n * **Advanced capabilities** like test composition (dependent tests), arbitrary scoring, engagement testing, etc.\n * **Ring middleware**\n\n## Getting started\n\nAdd the necessary dependency to your project:\n\n```clojure\nLeiningen: [com.taoensso/touchstone \"2.0.2\"] ; or\ndeps.edn:   com.taoensso/touchstone {:mvn/version \"2.0.2\"}\n```\n\nAnd setup your namespace imports:\n\n```clojure\n(ns my-ns\n  (:require [taoensso.touchstone :as touchstone :refer (*ts-id*)]))\n```\n\n### Split-testing\n\nTraditional split-testing consists of 4 steps:\n\n 1. Defining content variations (e.g. possible labels for a sign-up button)\n 2. Distributing content variations to test subjects (our users)\n 3. Recording events of interest (sign-ups) by variation\n 4. Analyzing the results and adopting our most successful content (best button label)\n\nThe particular multi-armed bandit technique used by Touchstone means that we only concern ourselves with steps 1 and 3. Steps 2 and 4 are handled automatically by the algorithm.\n\n#### To optimize a Ring web application\n\nStart by adding `(taoensso.touchstone.ring/wrap-test-subject-id)` to your middleware stack.\n\nOne or more test selectors can then be used as part of your page content:\n\n```clojure\n(touchstone/mab-select\n  {:conn-opts {} ; Optional, as per Carmine's `wcar` conn-opts\n   }\n  *ts-id* ; Dynamic test-subject-id (assigned by middleware)\n  :my-app/landing.buttons.sign-up ; Test id\n  :sign-up  \"Sign-up!\"   ; Named variation #1\n  :join     \"Join!\"      ; Named variation #2\n  :join-now \"Join now!\"  ; Named variation #3\n)\n```\n\nAnd relevant events (e.g. conversions) recorded:\n\n```clojure\n;; On sign-up button click, etc.:\n(touchstone/mab-commit!\n  {} ; Same opts as given to `mab-select`\n  *ts-id* :my-app/landing.buttons.sign-up 1)\n```\n\nTouchstone will now **automatically** start using accumulated statistical data to optimize the selection of the `:my-app/landing.buttons.signup` test variations for maximum clicks.\n\nAnd you're done! That's literally all there is to it.\n\nSee the `mab-select` and `mab-commit!` [API][] docs for info on more advanced capabilities like **multivariate testing, test composition (dependent tests), arbitrary scoring, engagement testing**, etc.\n\n## Contacting me / contributions\n\nPlease use the project's [GitHub issues page][] for all questions, ideas, etc. **Pull requests welcome**. See the project's [GitHub contributors page][] for a list of contributors.\n\nOtherwise, you can reach me at [Taoensso.com][]. Happy hacking!\n\n\\- [Peter Taoussanis][Taoensso.com]\n\n## License\n\nDistributed under the [EPL v1.0][] \\(same as Clojure).  \nCopyright \u0026copy; 2012-2022 [Peter Taoussanis][Taoensso.com].\n\n\u003c!--- Standard links --\u003e\n[Taoensso.com]: https://www.taoensso.com\n[Break Version]: https://github.com/taoensso/encore/blob/master/BREAK-VERSIONING.md\n[backers]: https://taoensso.com/clojure/backers\n\n\u003c!--- Standard links (repo specific) --\u003e\n[CHANGELOG]: https://github.com/taoensso/touchstone/releases\n[API]: http://taoensso.github.io/touchstone/\n[GitHub issues page]: https://github.com/taoensso/touchstone/issues\n[GitHub contributors page]: https://github.com/taoensso/touchstone/graphs/contributors\n[EPL v1.0]: https://raw.githubusercontent.com/ptaoussanis/touchstone/master/LICENSE\n[Hero]: https://raw.githubusercontent.com/ptaoussanis/touchstone/master/hero.png \"Title\"\n\n\u003c!--- Unique links --\u003e\n[A/B testing]: http://en.wikipedia.org/wiki/A/B_testing\n[multi-armed bandit]: http://en.wikipedia.org/wiki/Multi-armed_bandit\n[Carmine]: https://github.com/taoensso/carmine\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaoensso%2Ftouchstone","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftaoensso%2Ftouchstone","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftaoensso%2Ftouchstone/lists"}