{"id":14959456,"url":"https://github.com/aplbrain/tamarind","last_synced_at":"2025-10-24T16:31:59.104Z","repository":{"id":54879348,"uuid":"177684911","full_name":"aplbrain/tamarind","owner":"aplbrain","description":"manage multiple ephemeral neo4j containers","archived":false,"fork":false,"pushed_at":"2024-08-20T10:04:58.000Z","size":65,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-31T03:26:18.037Z","etag":null,"topics":["database","docker","graph","graph-database","neo4j","neo4j-database"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aplbrain.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2019-03-26T00:19:40.000Z","updated_at":"2024-08-20T10:05:01.000Z","dependencies_parsed_at":"2024-08-20T12:12:55.073Z","dependency_job_id":"e16a9845-3ace-429f-8bfb-6f4ee8090982","html_url":"https://github.com/aplbrain/tamarind","commit_stats":null,"previous_names":["aplbrain/tamarind","fitmango/tamarind"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aplbrain%2Ftamarind","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aplbrain%2Ftamarind/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aplbrain%2Ftamarind/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aplbrain%2Ftamarind/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aplbrain","download_url":"https://codeload.github.com/aplbrain/tamarind/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238008495,"owners_count":19401261,"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":["database","docker","graph","graph-database","neo4j","neo4j-database"],"created_at":"2024-09-24T13:19:46.665Z","updated_at":"2025-10-24T16:31:58.738Z","avatar_url":"https://github.com/aplbrain.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch3 align=center\u003etamarind\u003c/h3\u003e\n\u003ch3 align=center\u003e🥭\u003c/h3\u003e\n\u003ch6 align=center\u003emanage multiple ephemeral neo4j containers\u003c/h6\u003e\n\u003cp align=center\u003e\n\u003ca href=\"https://pypi.org/project/tamarind/\"\u003e\u003cimg alt=\"PyPI\" src=\"https://img.shields.io/pypi/v/tamarind.svg?logo=python\u0026logoColor=orange\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n\u003cimg src=\"https://img.shields.io/github/issues/aplbrain/tamarind.svg?style=for-the-badge\" /\u003e\n\u003cimg src=\"https://img.shields.io/github/license/aplbrain/tamarind.svg?style=for-the-badge\" /\u003e\n\u003ca href=\"https://hub.docker.com/layers/neo4j/library/neo4j/4.2\"\u003e\u003cimg src=\"https://img.shields.io/badge/Neo4j-4.2-9cf?style=for-the-badge\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n`tamarind` is a system that manages Neo4j databases by provisioning Docker container resources for you. The user-facing API provides access to a dictionary-like lookup for your databases, and allows you to start and stop database servers on the fly.\n\n## Installation\n\nInstall from PyPI using pip:\n\n```shell\npip3 install tamarind\n```\n\nYou will need Docker already installed if you intend to use the Docker provisioning service. You can install Docker with the script from `https://get.docker.com/`.\n\n## Usage\n\n### Creating a new db\n\n```python\nfrom tamarind import Neo4jDockerProvisioner\n\nN = Neo4jDockerProvisioner()\n\nN.start(\"MyDatabase\")\n```\n\nNow you can access this graph database through py2neo:\n\n```python\n\u003e\u003e\u003e N[\"MyDatabase\"]\n\u003cpy2neo.Graph\u003e\n```\n\nThe object returned is a [`py2neo.database.Graph`](https://py2neo.org/v4/database.html#py2neo.database.Graph) object:\n\n```python\n\u003e\u003e\u003e N[\"MyDatabase\"].run(\"MATCH (a:Person) RETURN a.name, a.born LIMIT 4\").data()\n[{'a.born': 1964, 'a.name': 'Keanu Reeves'},\n {'a.born': 1967, 'a.name': 'Carrie-Anne Moss'},\n {'a.born': 1961, 'a.name': 'Laurence Fishburne'},\n {'a.born': 1960, 'a.name': 'Hugo Weaving'}]\n\n\n```\n\n### List all\n\n```python\n\u003e\u003e\u003e N.ps().keys()\n['MyDatabase', 'OldDatabase']\n```\n\n### Stop a service\n\n```python\n\u003e\u003e\u003e N.stop(\"OldDatabase\")\n\u003e\u003e\u003e N.ps().keys()\n['MyDatabase']\n```\n\n## Custom Provisioners\n\nIf you provision Neo4j instances via resources other than Docker (e.g. via AWS EC2 AMIs), you can extend the `Neo4jProvisioner` class with `start` and `ps` function calls (`stop` is an optional implementation in Tamarind).\n\n## Legal\n\nLicensed under Apache 2.0. \n\n\u003e Copyright 2024 Johns Hopkins University Applied Physics Laboratory\n\u003e\n\u003e Licensed under the Apache License, Version 2.0 (the \"License\");\n\u003e you may not use this codebase except in compliance with the License.\n\u003e You may obtain a copy of the License at\n\u003e\n\u003e http://www.apache.org/licenses/LICENSE-2.0\n\u003e\n\u003e Unless required by applicable law or agreed to in writing, software\n\u003e distributed under the License is distributed on an \"AS IS\" BASIS,\n\u003e WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\u003e See the License for the specific language governing permissions and\n\u003e limitations under the License.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faplbrain%2Ftamarind","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faplbrain%2Ftamarind","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faplbrain%2Ftamarind/lists"}