Dataset Service

Dataset management service for the Pilot Platform.

Getting Started

Prerequisites

This project is using:

1. Poetry to handle the dependencies.

2. Redis to handle cache.

3. postgresql as database.

4. Install Docker.

5. Start container with project application.

   docker compose up
   

6. Visit http://127.0.0.1:5064/v1/api-doc for API documentation.

Installation & Quick Start

1. Clone the project.

   git clone [email protected]:PilotDataPlatform/dataset.git
   

2. Install dependencies.

   poetry install
   

3. Add environment variables into .env. taking in consideration .env.schema

4. Start project dependencies:

    docker-compose up -d redis
    docker-compose up -d postgres
   

5. Run any initial scripts, migrations or database seeders.

   poetry run alembic upgrade head
   

6. Run application.

   poetry run python -m dataset
   

7. Install Docker.

Startup using Docker

This project can also be started using Docker.

1. To build and start the service within the Docker container run.

   docker compose up
   

2. Migrations should run automatically on previous step. They can also be manually triggered:

   docker compose run --rm alembic upgrade head
   

Contribution

You can contribute the project in following ways:

• Report a bug
• Suggest a feature
• Open a pull request for fixing issues or adding functionality. Please consider using pre-commit in this case.
• For general guidelines how to contribute to the project, please take a look at the contribution guides

Acknowledgements

The development of the HealthDataCloud open source software was supported by the EBRAINS research infrastructure, funded from the European Union's Horizon 2020 Framework Programme for Research and Innovation under the Specific Grant Agreement No. 945539 (Human Brain Project SGA3) and H2020 Research and Innovation Action Grant Interactive Computing E-Infrastructure for the Human Brain Project ICEI 800858.

This project has received funding from the European Union’s Horizon Europe research and innovation programme under grant agreement No 101058516. Views and opinions expressed are however those of the author(s) only and do not necessarily reflect those of the European Union or other granting authorities. Neither the European Union nor other granting authorities can be held responsible for them.