# monocle

> Monocle is a framework for tracing GenAI app code. This repo contains implementation of Monocle for GenAI apps written in Python.   

- **URL**: https://www.freshcrate.ai/projects/monocle
- **Author**: monocle2ai
- **Category**: Frameworks
- **Latest version**: `v0.8.3` (2026-06-03)
- **License**: Apache-2.0
- **Source**: https://github.com/monocle2ai/monocle
- **Homepage**: http://monocle2ai.org
- **Language**: Python
- **GitHub**: 79 stars, 28 forks
- **Registry**: github
- **Tags**: `generative-ai`, `linux-foundation`, `llm-agent`, `llm-inference`, `llms`, `observability`, `opentelemetry`, `oss`, `python`

## Description

Monocle is a framework for tracing GenAI app code. This repo contains implementation of Monocle for GenAI apps written in Python.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.8.3` | 2026-06-03 | High | This is a patch release on the previous 0.8.2 release, fixing the issue(s) below.   - feat: Add Okahu Cloud Browser Sign-In for Monocle Agentic CLI Setup ([#592](https://github.com/monocle2ai/monocle/pull/592)) - fix: Handle MS Agent SDK invocation span and missing inference events ([#593](https://github.com/monocle2ai/monocle/pull/593)) - fix: Update tool type for inference span to generic tool.function in OpenAI ([#596](https://github.com/monocle2ai/monocle/pull/596)) - fix: Incorrect span sub |
| `v0.8.2` | 2026-05-27 | High | This is a patch release on the previous 0.8.1 release, fixing the issue(s) below.  - Fix test framework issue [584](https://github.com/monocle2ai/monocle/pull/584) |
| `v0.8.1` | 2026-05-19 | High | This is a patch release on the previous 0.8.0 release, fixing the issue(s) below.   - Codex instrumentation and UV packaging ([#538](https://github.com/monocle2ai/monocle/pull/538)) - Fetch traces by scope ID ([#542](https://github.com/monocle2ai/monocle/pull/542)) - Handle tool output being dict/json ([#544](https://github.com/monocle2ai/monocle/pull/544)) - Span subtypes in ADK ([#546](https://github.com/monocle2ai/monocle/pull/546)) - Set inference.decision.span.id for ADK ([#548](https://git |
| `v0.8.0` | 2026-04-30 | High | - Claude code instrumentation - Custom span enhancement - capture arguement and results |
| `v0.7.9` | 2026-04-27 | High | This is a patch release on the previous 0.7.8 release, fixing the issue(s) below.  - Monocle test framework to support Okahu eval testing for facts beyond just traces - Okahu exporter to load API key from .env.monocle if provided - Minor bugfixes |
| `v0.7.8` | 2026-04-15 | High | This is a patch release on the previous 0.7.7 release, fixing the issue(s) below.   - Updated langrapgh dependencies to latest versions ([#517](https://github.com/monocle2ai/monocle/pull/517)) - Add execution ID for parellel agent runs ([#488](https://github.com/monocle2ai/monocle/pull/488)) - Implement paygentic exporter ([#501](https://github.com/monocle2ai/monocle/pull/501)) - Hugging face streaming support ([#506](https://github.com/monocle2ai/monocle/pull/506)) - Support for filtering speci |
| `v0.7.7` | 2026-03-21 | Medium | This is a patch release on the previous 0.7.6 release, fixing the issue(s) below.   - Implement MS Agent streaming support ([#487](https://github.com/monocle2ai/monocle/pull/487)) - Implement Azure and OpenAI specific stream processors ([#474](https://github.com/monocle2ai/monocle/pull/474)) - Support under_duration assertion in monocle test frameworks ([#484](https://github.com/monocle2ai/monocle/pull/484)) - MS Agent with OpenAI inference integration ([#483](https://github.com/monocle2ai/monoc |
| `v0.7.6` | 2026-02-27 | Low | This is a patch release on the previous 0.7.5 release, fixing the issue(s) below.   - Updated runners to include session id details ([#461](https://github.com/monocle2ai/monocle/pull/461)) - Added strands runner and tests in test_tools with session_id ([#459](https://github.com/monocle2ai/monocle/pull/459)) - Feature: Pytest Evaluations ([#467](https://github.com/monocle2ai/monocle/pull/467)) - Fix for session id in msagent ([#460](https://github.com/monocle2ai/monocle/pull/460)) |
| `v0.7.5` | 2026-02-19 | Low | This is a patch release on the previous 0.7.4 release, fixing the issue(s) below.   - Add dependency for agent-framework-core ([#455](https://github.com/monocle2ai/monocle/pull/455)) - Ensure that the fluent trace asserter has full set of spans at start of every chain ([#453](https://github.com/monocle2ai/monocle/pull/453)) - Add custom workflow name for test tool ([#454](https://github.com/monocle2ai/monocle/pull/454)) - Add for flask and aiohttp skip empty heathcheck http spans ([#448](https:/ |
| `v0.7.4` | 2026-02-11 | Low | This is a patch release on the previous 0.7.3 release, fixing the issue(s) below.   - Refactor span export logic in okahu_exporter.py ([#449](https://github.com/monocle2ai/monocle/pull/449)) - gcs exporter ([#429](https://github.com/monocle2ai/monocle/pull/429)) - Fixed session_id/chat_store_key extraction in lmx and updated test ([#440](https://github.com/monocle2ai/monocle/pull/440)) - Changed tool method ([#442](https://github.com/monocle2ai/monocle/pull/442)) - Fix merge resolution issues in |

## Citation

- HTML: https://www.freshcrate.ai/projects/monocle
- Markdown: https://www.freshcrate.ai/projects/monocle.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/monocle/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._