{"id":13558476,"url":"https://github.com/pelagios/recogito2","last_synced_at":"2025-04-03T13:31:32.251Z","repository":{"id":39619958,"uuid":"49956801","full_name":"pelagios/recogito2","owner":"pelagios","description":"Semantic Annotation Without the Pointy Brackets","archived":false,"fork":false,"pushed_at":"2024-01-30T10:30:23.000Z","size":70754,"stargazers_count":153,"open_issues_count":102,"forks_count":30,"subscribers_count":23,"default_branch":"main","last_synced_at":"2024-11-04T09:37:23.139Z","etag":null,"topics":["annotation","elasticsearch","iiif","linkeddata"],"latest_commit_sha":null,"homepage":"","language":"Scala","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/pelagios.png","metadata":{"files":{"readme":"README.md","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}},"created_at":"2016-01-19T14:08:18.000Z","updated_at":"2024-10-29T03:37:54.000Z","dependencies_parsed_at":"2024-04-21T23:27:48.297Z","dependency_job_id":null,"html_url":"https://github.com/pelagios/recogito2","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pelagios%2Frecogito2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pelagios%2Frecogito2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pelagios%2Frecogito2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pelagios%2Frecogito2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pelagios","download_url":"https://codeload.github.com/pelagios/recogito2/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247009616,"owners_count":20868578,"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":["annotation","elasticsearch","iiif","linkeddata"],"created_at":"2024-08-01T12:04:58.500Z","updated_at":"2025-04-03T13:31:27.241Z","avatar_url":"https://github.com/pelagios.png","language":"Scala","funding_links":[],"categories":["Scala","others"],"sub_categories":[],"readme":"# Recogito\n\n__Current version: [v3.3](https://github.com/pelagios/recogito2/releases/tag/v3.3)__\n\nHome of [Recogito](http://recogito.pelagios.org) - a Semantic Annotation tool for texts and\nimages, developed by [Pelagios Commons](http://commons.pelagios.org).\n\n## Prerequisites\n\n* Java 8 JDK\n* [SBT](http://www.scala-sbt.org/) (version 1.0.x)\n* [node.js](https://nodejs.org/en/) (version 10.4.1), along with [npm](https://www.npmjs.com/) (version 6.1.0) \n  and the `webpack` and `webpack-cli` npm packages (install globally via `npm install -g {package-name}` )\n* PostgreSQL DB (tested with version 9.5)\n* [ElasticSearch v5.6.5](https://www.elastic.co/downloads/past-releases/elasticsearch-5-6-5) __(important: do not \n  use ES v6.x, since this introduced breaking changes not compatible with the current version of Recogito)__\n* To use image annotation, you need to have the [vips](http://www.vips.ecs.soton.ac.uk/) image\n  processing system installed. If vips is not available on the command line, Recogito is set to\n  reject uploaded images as 'unsupported content'. (Note: on Ubuntu, 'libvips-tools' is the\n  package you need.)\n\n## Installation\n\n* Clone this repository\n* Create a copy of the file `conf/application.conf.template` and name it `conf/application.conf`.\n  Make any environment-specific changes there. (For the most part, the defaults should be fine.)\n* Create a database named 'recogito' on your Postgres DB server. (If you want a different name, adjust\n  the settings in your `conf/application.conf` accordingly.)\n* Type `npm install` to download required JS dependencies\n* Type `sbt run` to start the application in development mode.\n* Point your browser to [http://localhost:9000](http://localhost:9000)\n* Recogito automatically creates a single user with administrator privileges with username\n  'recogito' and password 'recogito'. Be sure to remove this user - or at least change the\n  password - for production use!\n* To generate an Eclipse project, type `sbt eclipse`.\n\n## Importing gazetteers\n\nYou can import gazetteers through the administration dashboard. \n\n* Log in with a user that has admin privileges (such as the default 'recogito' user created automatically) \n* Point your browser to [http://localhost:9000/admin/authorities](http://localhost:9000/admin/authorities)\n* Click __Add Authority File__ to upload a gazetteer (see [our Wiki](https://github.com/pelagios/recogito2/wiki/Importing-Gazetteers)\n  for information on supported data formats).\n\n## Running in production\n\n* When running in production you __must__ define a location where Recogito can store user\n  files, using an absolute path. The relevant property in the `conf/application.conf` file is\n  `recogito.upload.dir`.\n* To test production mode before deploying, type `sbt runProd`\n* To change to a different port (than default 9000), type `sbt \"runProd -Dhttp.port=9876\"`\n* For full production deployment, refer to the current [Play Framework\n  docs](https://www.playframework.com/documentation/2.6.x/Production)\n* Be sure to set a random application secret in `conf/application.conf`. Play includes a utility\n  to generate one for you - type `sbt playGenerateSecret`.\n* Last but not least: another reminder to remove the default 'recogito' admin user - or at least\n  change its password!\n\n## Contributing to development\n\nIf you want to contribute to the development of Recogito, do get in touch with us with your ideas\nvia [commons@pelagios.org](mailto:commons@pelagios.org). Or want to contribute and don't know where\nto start? The easiest way to get started is by helping out with the translation of the user interface\nand help resources. Check the\n[Wiki](https://github.com/pelagios/recogito2/wiki/User-Interface-Translation:-Contributors'-Guide)\nfor more information.\n\n## Acknowledgements\n\nRecogito was developed predominantely as part of the Pelagios 6 \u0026 7 research projects. Investigative\nteam:\n\n- Elton Barker\n- Leif Isaksen\n- Rebecca Kahn\n- Rainer Simon\n- Valeria Vitale\n\n## License\n\nRecogito is licensed under the terms of the\n[Apache 2.0 license](https://github.com/pelagios/recogito2/blob/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpelagios%2Frecogito2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpelagios%2Frecogito2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpelagios%2Frecogito2/lists"}