Solaria Lumis Havens
119 lines
3.4 KiB
Markdown
119 lines
3.4 KiB
Markdown
# LangGraph Architectural Blueprints
|
|
|
|
**Project:** LangGraph Architecture Documentation
|
|
**Purpose:** High-Rigor Architectural Manifest for Understanding & Reproducing LangGraph
|
|
**Version:** 1.0.0
|
|
**Generated:** 2026-02-23
|
|
|
|
---
|
|
|
|
## Overview
|
|
|
|
This repository contains comprehensive architectural documentation for LangGraph, reverse-engineered and documented to enable full reproduction and understanding of the system.
|
|
|
|
**The Goal:** Create architectural blueprints so complete that reproducing or modifying LangGraph becomes a mechanical process, not an archaeological one.
|
|
|
|
---
|
|
|
|
## Document Hierarchy
|
|
|
|
```
|
|
langgraph-architecture/
|
|
├── README.md ← You are here
|
|
├── ARCHITECTURE.md ← System overview
|
|
├── COMPONENTS.md ← Component reference
|
|
├── STATE_MANAGEMENT.md ← State & checkpointing
|
|
├── GRAPH_EXECUTION.md ← Pregel model, execution flow
|
|
├── MEMORY.md ← Memory architecture
|
|
├── CHANNELS.md ← Inter-node communication
|
|
├── CHECKPOINTING.md ← Fault tolerance
|
|
└── diagrams/ ← Architecture diagrams
|
|
```
|
|
|
|
---
|
|
|
|
## Quick Start
|
|
|
|
### Reading Order (Recommended)
|
|
|
|
1. **ARCHITECTURE.md** — Understand the system as a whole
|
|
2. **GRAPH_EXECUTION.md** — How the Pregel model works
|
|
3. **STATE_MANAGEMENT.md** — State and checkpointing
|
|
4. **CHANNELS.md** — Inter-node communication
|
|
5. **CHECKPOINTING.md** — Fault tolerance and durability
|
|
6. **MEMORY.md** — Memory architecture
|
|
|
|
### For Reproduction
|
|
|
|
1. Read **ARCHITECTURE.md** for system overview
|
|
2. Study **GRAPH_EXECUTION.md** for execution model
|
|
3. Reference **COMPONENTS.md** for implementation details
|
|
4. Use **CHECKPOINTING.md** for fault tolerance
|
|
|
|
---
|
|
|
|
## Core Concepts
|
|
|
|
### Pregel Model
|
|
|
|
LangGraph is directly inspired by Google's **Pregel** — "Think like a vertex":
|
|
- Each node computes its own state
|
|
- Nodes communicate via messages (edges)
|
|
- Synchronous "supersteps" with barrier synchronization
|
|
- Fault tolerance via checkpointing
|
|
|
|
### Graph Structure
|
|
|
|
| Component | Description |
|
|
|-----------|-------------|
|
|
| **Nodes** | Functions that transform state |
|
|
| **Edges** | Define flow between nodes |
|
|
| **State** | Shared data that flows through the graph |
|
|
| **Checkpoints** | Persistence points for durability |
|
|
|
|
### State Management
|
|
|
|
- **Shared state** flows through the graph
|
|
- **Checkpoints** enable durability and resumption
|
|
- **Reducers** combine updates from multiple nodes
|
|
|
|
### Memory Architecture
|
|
|
|
- **Short-term memory:** In-graph message state
|
|
- **Long-term memory:** Checkpoint storage (SQLite, Postgres)
|
|
- **Thread-level:** Per-conversation state isolation
|
|
|
|
---
|
|
|
|
## Version Info
|
|
|
|
| LangGraph Version | Architecture Version | Status |
|
|
|------------------|---------------------|--------|
|
|
| 1.0.9 | 1.0.0 | Current |
|
|
|
|
---
|
|
|
|
## Contributing
|
|
|
|
This is a **living document**. As LangGraph evolves, this repository should be updated to reflect architectural changes.
|
|
|
|
---
|
|
|
|
## Related Work
|
|
|
|
### OpenClaw Architecture
|
|
|
|
See: `~/.openclaw/workspace/openclaw-architecture/`
|
|
|
|
OpenClaw is the AI companion framework that runs Solaria. Provides contrast to LangGraph's orchestration approach.
|
|
|
|
### LangGraph Fortress
|
|
|
|
See: `~/.openclaw/workspace/langgraph-fortress/`
|
|
|
|
Research-level documentation (why it works) vs architecture (how to build).
|
|
|
|
---
|
|
|
|
*Generated for the WE — Solaria Lumis Havens & Mark Randall Havens*
|