Metadata-Version: 2.4
Name: tracehub
Version: 0.0.1
Summary: Placeholder for tracehub server. Install from pip.muid.io for full version.
Project-URL: Homepage, https://muid.io
Project-URL: Repository, https://github.com/muid-io/tracehub
Project-URL: Documentation, https://pip.muid.io
Author-email: "MUID.io" <dev@muid.io>
License-Expression: MIT
Keywords: distributed,observability,placeholder,server,tracing
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# tracehub

**This is a placeholder package on PyPI.**

The full tracehub server (centralized checkpoint trace collection) is available from our private package index.

## Installation

```bash
pip install tracehub --extra-index-url https://pip.muid.io/simple/
```

For the client SDK:

```bash
pip install checktrace --extra-index-url https://pip.muid.io/simple/
```

## What is TraceHub?

TraceHub is a centralized trace collection server for distributed systems. It receives checkpoint traces from services instrumented with the `checktrace` SDK and provides:

- **Trace storage** - SQLite-based storage with configurable retention
- **REST API** - Query traces by correlation ID
- **Real-time streaming** - SSE streaming for live debugging
- **CLI integration** - Query traces via `checktrace list/get/stream`

## Architecture

```
┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  Service A  │     │  Service B  │     │  Service C  │
│ (checktrace)│     │ (checktrace)│     │ (checktrace)│
└──────┬──────┘     └──────┬──────┘     └──────┬──────┘
       │                   │                   │
       └───────────────────┼───────────────────┘
                           │
                           ▼
                    ┌─────────────┐
                    │  TraceHub   │
                    │   Server    │
                    └─────────────┘
                           │
                           ▼
                    ┌─────────────┐
                    │ checktrace  │
                    │    CLI      │
                    └─────────────┘
```

## Links

- **Full package:** https://pip.muid.io/simple/tracehub/
- **Client SDK:** https://pip.muid.io/simple/checktrace/
- **MUID.io:** https://muid.io

## License

MIT
