{"id":20649595,"url":"https://github.com/huygensing/timbuctoo","last_synced_at":"2025-09-12T10:39:43.370Z","repository":{"id":12612968,"uuid":"15284049","full_name":"HuygensING/timbuctoo","owner":"HuygensING","description":"an RDF datastore that gives researchers control over the sharing of data between datasets","archived":false,"fork":false,"pushed_at":"2024-05-01T16:41:57.000Z","size":44920,"stargazers_count":41,"open_issues_count":4,"forks_count":8,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-04-17T12:25:30.992Z","etag":null,"topics":["berkeley-db","graphql","humanities","java","r2rml","rdf"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HuygensING.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":"CONTRIBUTING.adoc","funding":null,"license":"LICENSE.txt","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,"zenodo":null}},"created_at":"2013-12-18T13:37:39.000Z","updated_at":"2024-12-15T22:02:27.000Z","dependencies_parsed_at":"2025-04-17T01:28:33.668Z","dependency_job_id":"9cc97f96-35df-40d1-9ecf-558f110f493a","html_url":"https://github.com/HuygensING/timbuctoo","commit_stats":null,"previous_names":[],"tags_count":230,"template":false,"template_full_name":null,"purl":"pkg:github/HuygensING/timbuctoo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HuygensING%2Ftimbuctoo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HuygensING%2Ftimbuctoo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HuygensING%2Ftimbuctoo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HuygensING%2Ftimbuctoo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HuygensING","download_url":"https://codeload.github.com/HuygensING/timbuctoo/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HuygensING%2Ftimbuctoo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274799464,"owners_count":25352171,"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","status":"online","status_checked_at":"2025-09-12T02:00:09.324Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["berkeley-db","graphql","humanities","java","r2rml","rdf"],"created_at":"2024-11-16T17:15:13.217Z","updated_at":"2025-09-12T10:39:43.341Z","avatar_url":"https://github.com/HuygensING.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"= Timbuctoo\n\nBridge to networked research data\n\n== Getting Started\n\n//tag::gettingstarted[]\n\n=== Prerequisites\nThe following prerequisites need to be installed on the machine before running the Timbuctoo program:\n\n    * https://java.com/en/download/[Java]\n    * https://maven.apache.org/download.cgi[Maven] \n    * https://git-scm.com/downloads[Git]\n    * https://www.docker.com/[Docker]\n    * http://xmlsoft.org/downloads.html[libxml2-utils]\n\n=== Start Timbuctoo without Docker\n==== Installation\nAfter the above requirements are fulfilled you can follow the following instructions to install Timbuctoo:\n\n    * Clone the https://github.com/HuygensING/timbuctoo.git[Timbuctoo Github repository] into a local directory using the command:\n\n    git clone https://github.com/HuygensING/timbuctoo.git\n \n==== Starting Timbuctoo\n    - On the Timbuctoo root directory run the Maven build command:\n\n      mvn clean package\n      \n    - On the \"/devtools/debugrun\" directory within your Timbuctoo repository, run:\n\n        ./timbuctoo_only.sh\n\n=== Start Timbuctoo with Docker\nTo start Timbuctoo only:\n----\n$ (sudo) docker run -p8080:80 huygensing/timbuctoo\n----\n\nTo start Timbuctoo with Timbuctoo GUI:\n----\n$ (sudo) docker-compose up\n----\n\n=== Uploading data\n    - You can run a curl command of the following format to upload data into Timbuctoo:\n\n    curl -v -F \"file=@/\u003ccomplete_path_to_file\u003e/\u003cfilename\u003e;type=\u003cfiletype\u003e\" -F \"encoding=UTF-8\" -H \"Authorization: fake\" http://localhost:8080/u33707283d426f900d4d33707283d426f900d4d0d/mydataset/upload/rdf?forceCreation=true\n  \n    `u33707283d426f900d4d33707283d426f900d4d0d` the user id of the user when no security is used.\n    `mydataset` will be the name of the dataset\n\n    - You can use the provided *_bia_clusius.ttl_* data as a example dataset. The \u003cfiletype\u003e for this is \"text/turtle\". It is available in the following folder:\n\n    \"/\u003ccomplete path to timbuctoo\u003e/src/test/resources/nl/knaw/huygens/timbuctoo/bia_clusius.ttl\"\n\n    - Note that the above method forces a creation at upload time. Creating a dataset before doing the upload can be done at path:\n\n    \"\u003chost\u003e/dataSets/{userId}/{dataSetId}/create\"\n\n\n=== Querying data and Applying Mutations\n\n    - With Timbuctoo running, you can access the https://github.com/graphql/graphiql[GraphIQL in-browser IDE] by pointing your web-browser to the following address:\n\n    http://localhost:8080/static/graphiql\n\n\n    - You can then refer to https://github.com/HuygensING/timbuctoo/blob/master/documentation/timbuctoo-graphql-api-guide.adoc[this Timbuctoo GraphQL API guide] for querying and mutation instructions with examples.\n\n//end::gettingstarted[]\n\n== FAQs/Q\u0026A\n\n//tag::faqs[]\n\n**I can't access my data from the GraphiQL and I get the error _\"SyntaxError: JSON.parse: unexpected character at line 1 column 1 of the JSON data\"_ on the right pane when I try to query for data.**\n\nIt is likely that the filepath given while using the *curl* command to load the dataset was incorrect. Please note that the filepath to the dataset should be given in full (i.e. complete path from\n   root) with a '@' symbol preceding it.\n//end::faqs[]\n\n\n\n== License\n\nTimbuctoo is licensed under the link:./LICENSE.txt[GPL license]\n\n== Contributing\n\nSee the link:./CONTRIBUTING.adoc[contribution guidelines]\n\n== Documentation\n\nRead about compiling, installing/running and using/developing timbuctoo in the link:./documentation[documentation] folder.\n\n== Acknowledgements\n\nTimbuctoo is and has been funded by\n\n * The Huygens Institute\n * Golden Agents (until 2022)\n * CLARIAH.nl (until 2018)\n * NDE (funding ends december 2016)\n\n'''\n\nThis repository is available online at https://github.com/HuygensING/timbuctoo\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuygensing%2Ftimbuctoo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhuygensing%2Ftimbuctoo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuygensing%2Ftimbuctoo/lists"}