Nighthawk

Nighthawk is an experimental Python library exploring a clear separation:

• Use hard control (Python code) for strict procedure, verification, and deterministic flow.
• Use soft reasoning (an LLM or coding agent) for semantic interpretation inside small embedded "Natural blocks".

Python controls all flow; the LLM or coding agent is constrained to small Natural blocks with explicit input/output boundaries. The same mechanism handles lightweight LLM judgments ("classify this sentiment") and autonomous agent executions ("refactor this module and write tests"). See Philosophy for the full design rationale.

This repository is a compact reimplementation of the core ideas of Nightjar.

Documentation

• Quickstart — Setup and first example.
• Tutorial — Learn from first principles.
• Practices — Guidelines, patterns, and testing.
• Providers — LLM providers and configuration.
• Coding agent backends — Claude Code and Codex integration.
• Philosophy — Design rationale and positioning.
• Design — Canonical specification.
• Roadmap — Future directions.
• API Reference — Auto-generated API documentation.
• For coding agents — LLM development reference.

References

• Nightjar (upstream concept): https://github.com/psg-mit/nightjarpy