demsking/oremi-ojo repository overview

⁠Oremi Ojọ

Oremi Ojọ is a technical service that provides access to weather forecasts, air quality information, pollen levels, and geocoding data. It exposes a comprehensive set of REST API endpoints designed for reliable integration into applications that require environmental and location intelligence. In addition to its REST interface, Oremi Ojọ includes an MCP interface for structured interactions and an agent endpoint that enables natural language queries over its data.

The name "Ojọ" comes from the Yoruba language and means "weather". It reflects the service's purpose of delivering current conditions, forecasts, and related environmental data. Like other services in the Oremi ecosystem—such as Oremi Akọrin and Oremi Isinmi—the name is concise, meaningful, and rooted in Yoruba, reinforcing a consistent identity while remaining easy to recognize and remember.

⁠Documentation

Find the Oremi Ojọ deployment and API documentation at https://demsking.gitlab.io/oremi-ojo⁠.

⁠Features

• Weather Forecasts: Retrieve detailed weather information, including temperature, humidity, wind speed, wind direction, sunrise, and sunset times.
• Air Quality Data: Access air quality metrics such as AQI, PM2.5, PM10, NO₂, and O₃ levels for specific locations.
• Pollen Data: Get information about pollen levels and types (e.g., grass, birch, olive) to help manage allergies and plan outdoor activities.
• Geocoding: Perform forward and reverse geocoding to find locations by name, address, or coordinates.
• Generative Responses: Use natural language queries to retrieve weather, air quality, or pollen data for specific locations.
• Multilingual Output: Responses are generated directly in the detected (or requested) output language.
• Multi-Service & Multi-Location Routing: A single query can request weather, air quality, and pollen for one or several places.
• Structured Pollen Schema: Pollen responses include units, dominant_pollen, and a per-pollen details map with level and severity.
• Dockerized: Easily deployable using the demsking/oremi-ojo Docker image.

⁠Contribute

Please follow CONTRIBUTING.md⁠.

⁠Versioning

Given a version number MAJOR.MINOR.PATCH, increment the:

• MAJOR version when you make incompatible API changes,
• MINOR version when you add functionality in a backwards-compatible manner, and
• PATCH version when you make backwards-compatible bug fixes.

Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.

See SemVer.org⁠ for more details.

⁠License

Copyright 2026 Sébastien Demanou. All Rights Reserved.

Licensed under the Apache License, Version 2.0. See the LICENSE⁠ for the complete license text.