winds-mobi / winds-mobi-api

Real-time weather observations: data api

winds-mobi-api

Python standalone asyncIO API that provides different endpoints to get weather data from winds.mobi mongodb.

Deployed API versions:

• winds.mobi/api/2.3/
• winds.mobi/api/2.2/
• winds.mobi/api/2/ -> 2.2

OpenAPI documentation:

• /doc
• /redoc

Run the project with docker compose (simple way)

Dependencies

• Docker

Create an .env file from .env.template read by docker compose:

• cp .env.template .env

Then start the api:

• docker compose up --build
• OpenAPI client: http://localhost:8001/doc

Run the project locally

Dependencies

• Python 3.11
• Poetry

Create an .env.localhost file from .env.localhost.template read by dotenv for our local commands:

• cp .env.localhost.template .env.localhost

Create python virtual environment and install dependencies

• poetry install

Activate python virtual environment

• poetry shell

Run the server

• dotenv -f .env.localhost run uvicorn --proxy-headers --root-path "${ROOT_PATH}" --port 8001 winds_mobi_api.main:app
• OpenAPI client: http://localhost:8001/doc

Licensing

winds.mobi is licensed under the AGPL License, Version 3.0. See LICENSE.txt