kyojo humanitarian coordination hub

README excerpt

# Kyōjo (共助) — Real-Time Humanitarian Coordination Hub

> A real-time disaster-preparedness and response platform for Japan, combining a six-subagent orchestrator with a live REST + SSE event feed.

![Status](https://img.shields.io/badge/status-MVP%20Phase%201-orange) ![Hackathon](https://img.shields.io/badge/Built%20with-Opus%204.7-purple) ![License](https://img.shields.io/badge/license-MIT-green)

**Built for the "Built with Opus 4.7" hackathon.** *Kyōjo* (共助) is the Japanese concept of mutual aid between neighbors in times of disaster.

## Overview

Kyōjo coordinates disaster preparedness and response in real time. A six-subagent orchestrator reasons over the evolving situation while a live REST + Server-Sent Events (SSE) feed pushes updates to connected clients, and a `/nearby` places proxy surfaces relevant facilities and resources.

This release is **MVP Phase 1** of a broader civic-resilience vision.

## Architecture

- **Six-subagent orchestrator** (LangGraph) — decomposes coordination tasks across specialized agents.
- **REST + SSE event feed** — streams live situational updates to the frontend.
- **`/nearby` places proxy** — wraps Google Places to locate shelters, hospitals, and resources.

## Tech Stack

Python · FastAPI · REST + SSE · LangGraph (6-subagent orchestrator) · Next.js · Google Places API

## Getting Started

```bash
git clone https://github.com/PascalBurume/kyojo-humanitarian-coordination-hub.git
cd kyojo-humanitarian-coordination-hub

# Backend
cd bac