Metadata-Version: 2.4
Name: fuju-trace-duckdb
Version: 0.1.11
Summary: DuckDB storage adapter for Fuju Trace
Project-URL: Homepage, https://github.com/vibeinging/fuju-trace
Project-URL: Repository, https://github.com/vibeinging/fuju-trace
Project-URL: Issues, https://github.com/vibeinging/fuju-trace/issues
Author: Fuju Trace
License-Expression: MIT
Requires-Python: >=3.10
Requires-Dist: duckdb<3,>=1.0
Requires-Dist: fuju-trace-sql==0.1.11
Description-Content-Type: text/markdown

# Fuju Trace DuckDB

DuckDB storage adapter for Fuju Trace. Install this package directly or use
the base SDK extra:

```bash
python -m pip install 'fuju-trace-duckdb==0.1.11'
# equivalent: python -m pip install 'fuju-trace[duckdb]==0.1.11'
```

```python
from fuju_trace import connect

with connect(duckdb_path="./trace.duckdb", tenant_id=1, initialize=True) as db:
    print(db.capabilities())
```

The package re-exports `DuckDBTraceStore` from the shared `fuju-trace-sql`
implementation and installs the DuckDB driver. Use one writer process per
database file. Text search is currently a substring scan; BM25 and vector
search are not available in this adapter. See the
[SQL adapter guide](https://github.com/vibeinging/fuju-trace/blob/main/fuju-trace-sql/README.md) for writing traces and filters.
