# Hyacinth — News Without the Noise

> Real-time, multi-source news aggregator that clusters articles into storylines using AI analysis.

## What is Hyacinth?

Hyacinth is a free, open news aggregator at https://hyacinth.news that ingests articles from dozens of RSS sources worldwide, analyzes them with AI, and clusters related articles into coherent storylines. It covers global news with particular depth in conflict zones, geopolitics, and breaking events.

## Key Features

- **Multi-source aggregation**: Ingests from Reuters, Associated Press, BBC, Al Jazeera, and dozens of regional sources across the Middle East, Europe, Asia, and the Americas.
- **AI-powered storylines**: Articles about the same event are automatically grouped into threads, giving readers a multi-perspective view.
- **Severity classification**: Each article is rated (breaking, major, minor, update) so readers can focus on what matters.
- **Geolocated map view**: Articles are geocoded and plotted on an interactive map for spatial context.
- **Monitor alerts**: Users can set up keyword and event-type monitors with push notification alerts.
- **No algorithmic feed manipulation**: Stories are ranked by recency and severity, not engagement metrics.

## Coverage Areas

Hyacinth aggregates news globally with sources tagged by country. Coverage includes but is not limited to:
Lebanon, Israel, Palestine, Syria, Iraq, Iran, Yemen, Egypt, Turkey, United States, United Kingdom, France, Germany, Russia, Ukraine, China, Japan, India, Pakistan, and international wire services.

## How It Works

1. RSS feeds are fetched every 5 minutes from configured sources
2. Each article is analyzed by AI for severity, event type, and key entities
3. Articles are embedded and clustered into storylines using cosine similarity
4. Geocoding extracts locations mentioned in articles
5. The feed updates every 30 seconds on the frontend

## Pages

- `/` — Main news feed with top stories and storyline threads
- `/about` — About Hyacinth, the project story
- `/map?thread={id}` — Geolocated map view for a specific storyline

## API

The read-only public API is available at https://hyacinth.news/api/:
- `GET /api/threads` — List storyline threads with articles
- `GET /api/threads/{id}` — Get a specific thread
- `GET /api/threads/{id}/geo` — Get geocoded articles for a thread
- `GET /api/sources` — List news sources

## Contact

Hyacinth is an independent project. Visit https://hyacinth.news/about for more information.