intellyweave

# IntellyWeave

<div align="center">

<p align="center">
    <img src="docs/demos/rat-lines/images/header.png" alt="IntellyWeave - OSINT Intelligence Platform" width="600">
</p>

[![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)](LICENSE)
![Project Status](https://img.shields.io/badge/status-beta-orange)
[![Built on Elysia](https://img.shields.io/badge/built%20on-Weaviate%20Elysia-green)](https://github.com/weaviate/elysia)
[![GitHub stars](https://img.shields.io/github/stars/vericle/intellyweave.svg?style=social&label=Star)](https://github.com/vericle/intellyweave)

</div>

**AI-powered OSINT platform that transforms document chaos into actionable intelligence through entity extraction, geospatial analysis, archive discovery, and hypothesis-driven investigation.**

---

[Quick Start](docs/getting-started/index.md) | [Installation](docs/getting-started/installation.md) | [Feature Guides](docs/guides/entity-extraction/index.md) | [Live Demo](https://app.supademo.com/embed/cmizklvt10rwr14g48e8zgl73)

---

## What is IntellyWeave?

IntellyWeave is an **Open-Source Intelligence (OSINT) analysis platform** that automatically extracts entities from documents, visualizes relationships on maps and network graphs, and employs multiple AI agents that debate complex questions to deliver well-reasoned answers with source citations.

Upload your documents. Ask questions in natural language. Get intelligence.

## Mission

IntellyWeave democratizes intelligence analysis by making professional-grade OSINT workflows accessible through AI automation. We eliminate the manual labor of entity extraction, relationship mapping, and geographic analysis—transforming months of work into minutes.

## Who Should Use This?

**IntellyWeave is for teams who need to:**

- **Intelligence Analysts** — Conduct OSINT research, connect disparate sources, build comprehensive assessments
- **Historical Researchers** — Explore archives, declassified documents, and primary sources for patterns and narratives
- **Investigators** — Track entities across documents, piece together evidence, build case narratives
- **Research Professionals** — Extract structured data from unstructured sources, discover non-obvious relationships

## Scope

### In Scope

- Automatic entity extraction (persons, organizations, locations, dates, events, laws, cryptonyms)
- Geospatial visualization with interactive 3D maps
- Network relationship analysis and graph visualization
- Archive discovery and hypothesis-driven investigation (Quartermaster + Case Officer)
- Multi-agent reasoning for complex analytical questions
- Multi-format document processing (PDF, DOCX, TXT, Markdown)
- Multi-provider LLM support (OpenAI, Anthropic, Google, local models)

### Out of Scope

- Legal case analysis (that's [Spectre's](https://github.com/Siddharth-Khattar/specter-backend) domain)
- Real-time surveillance or monitoring
- Automated decision-making without human review

## Key Features

### Entity Extraction (GLiNER)

Automatic identification of 7 entity types from multilingual documents using zero-shot recognition. No training required.

<p align="center">
    <img src="docs/guides/entity-extraction/images/01_intelligence_entity_extractor.png" alt="Entity Extractor - GLiNER Analysis" width="700">
</p>

*Entity Extractor identifying key persons with 92% confidence, enriched with contextual analysis and follow-up suggestions.*

| Entity Type | Examples |
|-------------|----------|
| Persons | Klaus Barbie, Josef Mengele |
| Organizations | Vatican, CIA, ODESSA |
| Locations | Buenos Aires, Rome, Damascus |
| Dates | May 1945, 1960s |
| Events | Nuremberg Trials |
| Laws | Decreto-Lei 7967/1945 |
| Cryptonyms | Operation Paperclip |

[Entity Extraction Guide](docs/guides/entity-extraction/index.md)

### Geospatial Intelligence

Interactive 3D maps powered by Mapbox GL. Plot extracted locations, visualize routes, explore geographic patterns.

<p align="center">
    <img src="docs/guides/geospatial-mapping/images/03_intelligence_geospatial_analyst.png" alt="Geospatial Analyst - Location Intelligence" width="700">
</p>

*Geospatial Analyst extracting operational locations with coordinates, route data, and strategic intelligence assessments.*

<p align="center">
    <img src="docs/guides/geospatial-mapping/images/mapbox-view.png" alt="Mapbox Heatmap Visualization" width="700">
</p>

*Interactive Mapbox heatmap showing location intensity across Italy—key embarkation points for transatlantic escape routes.*

[Geospatial Mapping Guide](docs/guides/geospatial-mapping/index.md)

### Network Analysis

Relationship graphs with physics-based layouts using vis-network. Discover hidden connections between entities.

<p align="center">
    <img src="docs/guides/network-analysis/images/network-fullscreen.png" alt="Network Graph - Relationship Visualization" width="700">
</p>

*Force-directed network graph revealing the rat lines organization: persons (orange), organizations (green), and locations (blue) with documented relationship edges.*

[Network Analysis Guide](docs/guides/network-analysis/index.md)

### Archive Research

Two-agent investigative system for archival discovery and hypothesis-driven research:

| Agent | Role |
|-------|------|
| **Quartermaster** | Maps the information landscape—discovers archives, classifies access levels, identifies digitization status |
| **Case Officer** | Conducts the investigation—tests hypotheses, gathers evidence, synthesizes reports with actionable next steps |

<p align="center">
    <img src="docs/guides/archive-research/images/hypotheses-list.png" alt="Archive Research - Hypothesis Testing" width="700">
</p>

*Case Officer generates structured hypotheses with evidence tracking: Confirmed (85%), Indeterminate (45%), Pending, or Refuted—each with supporting and contradicting evidence.*

**Key capabilities:**
- Curated archive sources (30+ institutions across 10 geographic regions)
- Access level classification (Public, Subscription, Physical-Only, Restricted)
- Hypothesis generation with confidence scoring and evidence citations
- Step-by-step access instructions for restricted archives
- Intelligent PDF preview with AI-inferred schema
- Documents flagged for manual review with rich metadata for follow-up

[Archive Research Guide](docs/guides/archive-research/index.md) | [Configuration Guide](docs/guides/archive-research/configuration.md)

### Intelligence Orchestrator

Automated 6-phase analysis pipeline that transforms uploaded documents into comprehensive intelligence assessments with actionable follow-up tasks:

| Phase | Agent | Output |
|-------|-------|--------|
| **1. Extraction** | Entity Extractor | Persons, organizations, locations, dates, events, laws, cryptonyms |
| **2. Mapping** | Relationship Mapper | Entity connections with relationship types and confidence scores |
| **3. Geospatial** | Geospatial Analyst | Location coordinates, routes, movement patterns |
| **4. Network** | Network Analyst | Graph structures, centrality metrics, cluster detection |
| **5. Patterns** | Pattern Detector | Cross-document correlations, temporal sequences, anomalies |
| **6. Synthesis** | Synthesizer | Executive summary, key findings, unresolved questions |

<p align="center">
    <img src="docs/guides/ticket-display/images/task-list-overview.png" alt="Intelligence Orchestrator - Task Generation" width="700">
</p>

*Intelligence Orchestrator generates follow-up investigation tasks from each analysis phase—color-coded by originating agent with priority indicators (High, Medium) and status tracking.*

**Key capabilities:**
- Automatic task generation from each analysis phase
- Priority-weighted investigation queue
- Provenance tracking (which agent generated each finding)
- Confidence accumulation across phases
- Executive summary with evidence citations

[Intelligence Analysis Guide](docs/guides/intelligence-analysis/index.md) | [Ticket Display Guide](docs/guides/ticket-display/index

[truncated…]