Blue Intelligence

A Berry-Mappemonde project. Code is MIT or Apache-2.0.

Warning

Ne convient pas à la navigation / Not for navigation. Les cartes et les chiffres viennent de sources publiques et de calculs. Ce n’est pas une carte marine officielle. Vérifiez toujours les publications gouvernementales avant une décision en mer.

Blue Intelligence (blueintelligence.online) is the memory of maritime sources: Ports of Entry per EEZ, marinas, harbour offices (capitaineries), marine protected areas, ocean science and marine projects. Each record keeps its official source. An unknown field stays empty; no figure is invented.

The live voyage application NAVIGUIDE is a separate repository: github.com/Berry-Mappemonde/NAVIGUIDE (naviguide.fr). It reads Blue Intelligence over its public API, https://blueintelligence.online/api.

Dependencies

Part	Runtime	Dependencies
API (backend/)	Python 3.12	backend/requirements.txt (FastAPI, Motor/PyMongo, httpx, trafilatura, PyMuPDF, shapely…)
Database	MongoDB (local or Atlas)	database name from DB_NAME
Map (frontend/)	Node.js (version in .nvmrc)	frontend/package.json (React, Create React App, MapLibre/Leaflet, Tailwind)
Optional AI and search	—	NVIDIA NIM (Nemotron), OpenRouter, Anthropic, TinyFish, Serper, SearXNG, GeoNames. Without keys the API still runs; AI steps fall back to rules or are skipped.

Installation (macOS / Linux)

git clone https://github.com/Berry-Mappemonde/Blue-Intelligence.git
cd Blue-Intelligence

# API
cd backend
python3.12 -m venv .venv
.venv/bin/pip install -r requirements.txt
cat > .env <<'EOF'
MONGO_URL=mongodb://127.0.0.1:27017
DB_NAME=blueintel_db
CORS_ORIGINS=*
EOF
cd ..

# Map
cd frontend
npm ci
cd ..

Keys go in backend/.env only, never in git: NVIDIA_API_KEY, OPENROUTER_API_KEY, ANTHROPIC_API_KEY, TINYFISH_API_KEY, SERPER_API_KEY, SEARXNG_URL, GEONAMES_USERNAME, ADMIN_KEY. LLM_PROVIDER=nvidia|openrouter|auto selects the model provider.

Optional sample data (the same seed the CI uses):

cd backend
MONGO_URL=mongodb://127.0.0.1:27017 DB_NAME=blueintel_db .venv/bin/python scripts/seed_ci_mongo.py

Usage

# API on http://127.0.0.1:8001/api/
cd backend && .venv/bin/uvicorn app.main:app --host 127.0.0.1 --port 8001

# Map on http://localhost:3000 (another terminal)
cd frontend && REACT_APP_BACKEND_URL=http://127.0.0.1:8001 npm start

Tests:

cd backend && .venv/bin/python -m pytest tests -q      # needs MongoDB and the API running
cd frontend && npm test                                # Jest

Production runs on an OVH VPS (infra/vps/README.md): every merge on main passes CI (.github/workflows/ci.yml) and deploys blueintelligence.online (.github/workflows/deploy.yml).

Architecture: docs/ARCHITECTURE.md. Documentation index: docs/README.md.

Licence

Code is MIT or Apache License 2.0 (LICENSE-MIT, LICENSE-APACHE). Data (OpenStreetMap, Marine Regions, EMODnet…) keeps its original licence. Nemotron weights remain under the NVIDIA licence.

---

Français (résumé)

Blue Intelligence est la mémoire des sources maritimes (ports d'entrée par ZEE, marinas, capitaineries, aires protégées, science, projets), en production sur blueintelligence.online. Le voyage en direct NAVIGUIDE est dans son propre dépôt : github.com/Berry-Mappemonde/NAVIGUIDE. Installation et usage : voir les sections ci-dessus (Python 3.12, MongoDB, Node.js ; backend/.env pour MONGO_URL, DB_NAME et les clés).

Licence

Le code est sous MIT ou Apache License 2.0 (LICENSE-MIT, LICENSE-APACHE). Les données (OpenStreetMap, Marine Regions, EMODnet…) gardent leur licence d’origine. Les poids Nemotron restent sous licence NVIDIA.

Index des plans : docs/README.md.