The definitive coordination protocol for the agentic era.
SOUP is the engine that transforms individual agent actions into a collective, auditable, and goal-oriented shared context.
SOUP defines the fundamental rules for agentic coordination:
- Mandatory Intent: Every mutation must be justified by an atomic intent string.
- Hierarchical Paths: Context-as-files structure that LLMs understand natively.
- Unified Purpose: The synthesis of all individual intents into a single mission.
- Deterministic State: No probabilistic "guessing"—just the absolute source of truth.
SOUP is a recursive acronym: Soup Organizes Unified Purpose. In Spanish: Sopa Organiza Propósitos Agénticos (SOPA).
- Core Engine: soup-oss/soup (This repo).
- Behavioral Library: soup-oss/recipes.
- Secure Platform: heysoup.co (Managed IaaS).
We are currently extracting the core protocol from our infrastructure repo. The engine will be released here soon.