Linkurator API allows you to explore and categorise your YouTube subscriptions.

The API is currently available at https://api.linkurator.com/docs

• Python 3.13 with pip and venv
• Docker
• Docker Compose

The requirements can be installed with:

make install-requirements

1. Install the dependencies with:

make install make docker-run-external-services

2. Get the encryption key and store it securely

echo "YOUR_PASSWORD" > secrets/vault_password.txt export LINKURATOR_VAULT_PASSWORD=$(cat secrets/vault_password.txt)

3. Select the environment with:

export LINKURATOR_ENVIRONMENT=DEVELOPMENT

Available environments are:

• DEVELOPMENT
• PRODUCTION

The project is composed of two services: the API and the processor:

• The API allows you to explore your subscriptions
• The processor is in charge of fetching the data from YouTube.

Run the API with your local python venv:

make run-api

Or with docker:

make docker-build make docker-run-api

Once you have the API running, you can access the documentation at http://localhost:9000/docs

Run the processor with your local python venv:

make run-procesor

Or with docker:

make docker-build make docker-run-processor

1. Use your web browser to access to the login page: http://localhost:9000/login
2. Login with your Google account
3. The processor must be running in order to download the data from your subscriptions
4. You can use the API docs to explore your subscriptions: http://localhost:9000/docs

Run the tests with your local python venv:

make test

Or with docker:

make docker-build make docker-test

Run the linter with your local python venv:

make lint

Or with docker:

make docker-build make docker-lint

Define the ip of the server to provision and deploy:

export SSH_IP_ADDRESS=api.linkurator.com

Define the encryption key:

export LINKURATOR_VAULT_PASSWORD=$(cat secrets/vault_password.txt)

Then you need to provision a server with docker.

make provision

Once the server is provisioned, you can deploy the application with:

make docker-build make docker-push make deploy

Every push to the master branch will trigger the tests and the linting. If they pass, the application will be automatically deployed to the server.