Description
NarrativeTrace is a tracing library designed to replace traditional log statements by deriving narratives from running code. It supports multiple programming languages, including TypeScript, Java, .NET, and Python. The tool is free and source-available under the Business Source License 1.1, converting to Apache 2.0 four years after each release. NarrativeTrace integrates with existing logging stacks via SLF4J, allowing narrative events to flow through the same appenders and log files already in use.
Read More
The library offers features such as automatic tracing, narration decorators, and HTTP middleware across all supported runtimes. It provides a value-free .nt artifact, ensuring no runtime values are leaked, making it safe for AI agents. The tool also supports OpenTelemetry for trace correlation across services, although this feature is currently limited to Java, Python, and TypeScript.
NarrativeTrace is designed for both human and AI consumption, offering prose that reads like bug reports and Markdown for context windows. It reduces token usage by 15–30% compared to traditional log statements. The tool is particularly useful for teams looking to migrate systems with traceability and clarity, offering features like clarity scoring and domain glossaries.
The tool is free to use in production, with commercial Pro and Enterprise editions planned, offering additional features like flow summaries, path frequency analysis, and audit events. NarrativeTrace is available on Maven Central, nuget.org, and GitHub, with documentation provided for each runtime.
- CategoryMLOps & Model Deployment
- Pricing ModelFree
- DeploymentOn-Premise
- PlatformsTypeScript, Java, .NET, Python
NarrativeTrace's Core Features
Automatic tracing for multiple runtimes
Integration with SLF4J logging stack
Value-free .nt artifact for AI safety
OpenTelemetry support for trace correlation
Prose and Markdown output formats
Clarity scoring and domain glossaries
Free and source-available under BSL 1.1
Commercial Pro and Enterprise editions planned
Available on Maven Central, nuget.org, and GitHub
Documentation for each runtime
How to use NarrativeTrace?
Add NarrativeTrace to your project
Configure SLF4J integration
Capture and review narrative traces
Optimize trace settings for your needs
NarrativeTrace's Use Cases
- Code Narration
- AI Integration
- Logging Enhancement
- System Migration
- Trace Correlation
