Metadata-Version: 2.4
Name: oremi-ojo
Version: 3.0.0b18
Summary: A comprehensive climate agent for weather forecasts, geocoding, and pollen data
Project-URL: Say Thanks!, https://www.buymeacoffee.com/demsking
Project-URL: Documentation, https://demsking.gitlab.io/oremi-ojo
Project-URL: Source, https://gitlab.com/demsking/oremi-ojo
Project-URL: Issues, https://gitlab.com/demsking/oremi-ojo/-/issues
Author-email: Sébastien Demanou <demsking@gmail.com>
Maintainer-email: Sébastien Demanou <demsking@gmail.com>
License: Apache-2.0
License-File: LICENSE
License-File: LICENSE_HEADER.txt
Keywords: air quality,forecast,geocoding,pollen
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Natural Language :: French
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Requires-Dist: fastapi[standard]>=0.115.12
Requires-Dist: mcp>=1.28.1
Requires-Dist: openmeteo-requests>=1.4.0
Requires-Dist: pydantic-settings>=2.14.2
Requires-Dist: pytz>=2026.2
Requires-Dist: requests-cache>=1.2.1
Requires-Dist: retry-requests>=2.0.0
Description-Content-Type: text/markdown

# Oremi Ojọ

[![Buy me a beer](https://img.shields.io/badge/Buy%20me-a%20beer-1f425f.svg)](https://www.buymeacoffee.com/demsking)

**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.

![Oremi Ojọ Logo](https://gitlab.com/demsking/oremi-ojo/-/raw/main/htdocs/logo.png)

## Documentation

Find the Oremi Ojọ deployment and API documentation at
[https://demsking.gitlab.io/oremi-ojo](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](https://gitlab.com/demsking/oremi-ojo/blob/main/CONTRIBUTING.md).

## Versioning

Given a version number `MAJOR.MINOR.PATCH`, increment the:
This project adheres to [Semantic Versioning](https://semver.org/) (SemVer).
Version numbers follow the `MAJOR.MINOR.PATCH` format:

- **MAJOR** version increments for incompatible API changes
- **MINOR** version increments for backward-compatible new functionality
- **PATCH** version increments for backward-compatible bug fixes

## License

Copyright 2026 Sébastien Demanou. All Rights Reserved.

Licensed under the Apache License, Version 2.0. See the
[LICENSE](https://gitlab.com/demsking/oremi-ojo/-/blob/main/LICENSE) for the
complete license text.
