Agent-contracts, contract-based LangGraph agents
Get picks like this daily. Today's launch numbers, the top launches, AI and tech news, and a daily opportunity pick, straight to your inbox.
Want to reach these readers? Sponsor an issue.
Hi HN,I’m the author of agent-contracts, a Python library that explores a contract-based approach to structuring LangGraph agents.When building larger LangGraph-based systems, I kept running into the same issues: - node responsibilities becoming implicit - state dependencies spreading across the graph - routing logic getting harder to reason about - refactoring feeling increasingly riskyagent-contracts is an attempt to make these boundaries explicit. Each node declares a contract that describes: - which parts of the state it reads and writes - what external services it depends on - when it should run, using rule-based conditions with optional LLM hintsFrom these contracts, the LangGraph structure can be assembled in a more predictable and inspectable way.This is still early-stage and experimental. I’m mainly interested in feedback on the design trade-offs and whether this mental model resonates with others building complex agent systems.
HN · launched Jan 9, 2026 · 8 upvotes (top 58%) · 0 views
Niche: ai agent development platforms · 598 launches, 22 in the last 7 days ▼ -29% · Explore this niche →
Category and tags
- Horizontal
- Agent / copilot
- Developer
- AI-native
- Hobby / open-source project
Visit website ↗ Source listing ↗
More like this: all 598 launches in ai agent development platforms →
Could you build this?
Yes This is a lightweight Python framework/abstraction layer defining schema contracts (e.g., via Pydantic) on top of LangGraph nodes and state graphs.
Discussion
No comments on this launch.
Competitors
Other products that read as similar to this one : 1089 launches clear the similarity bar, closest 8 shown.
Attention rank: #604 of 1090 (itself plus its competitors, highest first, normalized so YC and Product Hunt are compared fairly).
Launched 70 days after the earliest competitor.
- agent-graph-engineering · github · 2026-10-08 · 11 upvotes · similarity 0.60
- HyperFlow · hn · 2026-04-11 · 8 upvotes · similarity 0.52
- agents-contract · github · 2026-10-19 · 40 upvotes · similarity 0.51
- Langchain_DG · github · 2026-09-13 · 32 upvotes · similarity 0.49
- ai-agent-langgraph-main · github · 2026-09-11 · 21 upvotes · similarity 0.48
- AgentLog · hn · 2026-03-13 · 9 upvotes · similarity 0.48
- Agent Forge, an agent framework, heuristic routing and graph execution · hn · 2026-03-27 · 5 upvotes · similarity 0.48
- naiyue-test-agent · github · 2026-10-09 · 20 upvotes · similarity 0.47
The niche, labels, vibe code rating and competitor comparison on this page are analysis by Nicheloom. If you use them, please credit nicheloom.com. How you may use our data.