{"id":18994412,"url":"https://github.com/xtdb/2x-playground","last_synced_at":"2025-09-06T06:31:43.966Z","repository":{"id":59694234,"uuid":"516464713","full_name":"xtdb/2x-playground","owner":"xtdb","description":"Developer Experience experimentation for 2.x","archived":false,"fork":false,"pushed_at":"2024-01-10T23:49:29.000Z","size":249,"stargazers_count":6,"open_issues_count":1,"forks_count":5,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-11-08T17:33:18.039Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xtdb.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2022-07-21T17:33:11.000Z","updated_at":"2023-11-02T15:31:41.000Z","dependencies_parsed_at":"2023-12-15T19:39:40.414Z","dependency_job_id":"a9bb2853-4be6-4e16-8500-06a8d66a4cdf","html_url":"https://github.com/xtdb/2x-playground","commit_stats":null,"previous_names":["xtdb/2x-playground"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xtdb%2F2x-playground","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xtdb%2F2x-playground/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xtdb%2F2x-playground/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xtdb%2F2x-playground/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xtdb","download_url":"https://codeload.github.com/xtdb/2x-playground/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":232098350,"owners_count":18472317,"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":[],"created_at":"2024-11-08T17:25:30.010Z","updated_at":"2025-01-01T15:41:35.401Z","avatar_url":"https://github.com/xtdb.png","language":"HTML","readme":"= 2x-playground\n\nThis repository provides a wide range of examples which allow you to experiment with the XTDB's UX.\n\n----\n.\n├── README.adoc\n├── SQL.adoc\n│\n│   # clients:\n├── clojure\n├── psql\n├── python\n│\n│   # servers:\n├── xtdb-server-clj\n└── xtdb-server-docker\n----\n\n== Start a server\n\n=== Option 1: Docker\n\n[source,sh]\n----\ndocker pull ghcr.io/xtdb/xtdb-ea\ndocker run -ti --rm -p 5432:5432 -p 9832:9832 -p 3000:3000 ghcr.io/xtdb/xtdb-ea:latest\n----\n\n=== Option 2: JAR\n\nTODO\n\n=== Option 3: Clojure in-process\n\n* Make sure Clojure is installed\n* `cd xtdb-server-clj \u0026\u0026 ./run.sh`\n\n\n== XTDB SQL\n\nThe SQL dialect available in XTDB tries very hard to adhere to the SQL Specification.\nThere are small deviations from the spec where absolutely required.\nRead more in https://github.com/xtdb/2x-playground/blob/main/SQL.adoc[`SQL.adoc`].\n\n\n== psql\n\nInstall `psql` (Postgres) if you don't have it already.\nSome package managers offer the Postgres client in isolation\n(ubuntu has `postgresql-client`) but this is surprisingly uncommon.\n\n[source,sh]\n----\nsudo apt-get install -y postgresql\nsudo pacman -S postgresql\nbrew install postgresql\n# etc.\n----\n\n* Start an XTDB server\n* Run `./psql/run.sh` to start a client\n* Try a query from `./psql/queries.sql`\n\n\n== Python\n\n* Start an XTDB server\n* Install dependencies: `./python/install.sh`\n* Edit and run `./python/queries.py`\n\n\n== Clojure\n\nThe Clojure examples consume XTDB directly, running a client and server in the same process for convenience.\nThis means you do not need to start an external XTDB server.\n(Though you still can, of course.)\nThe client code still speaks to XTDB over the `pgwire` protocol using JDBC.\n\n`./clojure/README.adoc`\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxtdb%2F2x-playground","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxtdb%2F2x-playground","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxtdb%2F2x-playground/lists"}