medelmouhajir/bam-fx-rates-wan
Domaine:
digital infrastructureType de record:
software
Créateur:
med
Hôte:
Fetches live Moroccan Dirham (MAD) exchange rates and monetary statistics from the Central Bank of Morocco (BAM).
# Bank Al-Maghrib Exchange Rates & Monetary Stats (ISLI Skill)
This repository contains the `bam-fx-rates-wan` ISLI AI Skill. It is a standalone Dockerized HTTP microservice built on FastAPI that conforms to the **ISLI v2.0 Universal Skill Runtime (USR)**.
The skill provides ISLI AI agents with the ability to query the Bank Al-Maghrib (BAM) public developer API for live Moroccan Dirham (MAD) exchange rates and broad monetary statistics.
## Features
- **Get Exchange Rates**: Fetches the daily reference exchange rates for MAD against major currencies.
- **Get Monetary Stats**: Retrieves specific macro-economic indicators provided by BAM.
## Prerequisites
- Docker (recommended) or Python 3.9+
- A valid BAM API Key
### How to get an API Key
1. Go to the Bank Al-Maghrib API Portal.
2. Create a free developer account and verify your email.
3. Log in, go to the **Products** section, and subscribe to the relevant API products.
4. Copy your `Primary key` from your profile.
## Running Locally (Without Docker)
1. Install dependencies:
```bash
pip install -r requirements.txt
```
2. Start the FastAPI server (uses the default API key set in `main.py` or your own):
```bash
BAM_API_KEY="your_api_key_here" uvicorn main:app --reload
```
The service will be running at `127.0.0.1`.
## Running with Docker (Production/ISLI Core)
ISLI Core automatically pulls the repository and builds the Docker container. To test this manually:
1. Build the image:
```bash
docker build -t isli-skill-bam-fx .
```
2. Run the container:
```bash
docker run -p 8000:8000 -e BAM_API_KEY="your_api_key_here" -e JWT_SECRET="your_secret" isli-skill-bam-fx
```
## ISLI Integration
This skill requires an `X-Internal-Auth` header with a valid JWT on every tool request. This ensures secure communication between the ISLI Core engine and this skill container. The JWT is signed using the `JWT_SECRET` environment variable.
### Core Endpoints
- `GET /health` : Container health check.
- `GET /.well-know …