Metadata-Version: 2.4
Name: lfx-liam-bundle
Version: 0.0.3
Summary: Liam's personal Langflow extension toolkit (liam bundle). Currently ships GraphRAG components; more tools can be added under the same package.
Project-URL: Homepage, https://github.com/loadingvx/lfx-liam-bundle
Project-URL: Documentation, https://github.com/loadingvx/lfx-liam-bundle#readme
Project-URL: Repository, https://github.com/loadingvx/lfx-liam-bundle
Project-URL: Issues, https://github.com/loadingvx/lfx-liam-bundle/issues
Project-URL: Changelog, https://github.com/loadingvx/lfx-liam-bundle/blob/main/CHANGELOG.md
Project-URL: Langflow Extensions, https://docs.langflow.org/extensions-quickstart
Author: Liam
Maintainer: Liam
License: MIT
License-File: LICENSE
Keywords: bundle,components,extension,graphrag,langflow,lfx,liam,toolkit
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Typing :: Typed
Requires-Python: <3.15,>=3.10
Requires-Dist: astrapy<3.0.0,>=2.1.0
Requires-Dist: igraph>=0.11
Requires-Dist: langchain-core>=0.3.0
Requires-Dist: leidenalg>=0.10
Requires-Dist: lfx<2.0.0,>=1.11.0
Requires-Dist: networkx>=3.2
Requires-Dist: python-arango<9.0.0,>=8.0.0
Requires-Dist: tiktoken>=0.7
Description-Content-Type: text/markdown

# lfx-liam-bundle

[![Publish](https://github.com/loadingvx/lfx-liam-bundle/actions/workflows/python-publish.yml/badge.svg)](https://github.com/loadingvx/lfx-liam-bundle/actions/workflows/python-publish.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
[![LFX Extension](https://img.shields.io/badge/langflow-extension-0ea5e9.svg)](https://docs.langflow.org/extensions-quickstart)

[Chinese README](README.zh-CN.md)

Personal **Langflow extension toolkit** (`liam` bundle): a growing set of UI components and shared libraries for Liam’s Langflow workflows. GraphRAG is one capability shipped today—not the whole product.

## Architecture

```text
langflow.extensions entry-point
  └─ lfx_liam_bundle / extension.json
       └─ bundle: liam
            └─ components/liam/*     # Langflow UI components
       └─ domain packages (e.g. graphrag/*)
```

| Layer | Role |
|-------|------|
| `extension.json` | Extension id, display name, bundle registration |
| `components/liam/` | Langflow components (inputs, validation, UI copy) |
| Domain packages | Reusable logic behind components (currently `graphrag/`) |

New tools should land as new components (and optional domain packages) under the same `liam` bundle—without forcing every feature into GraphRAG.

## Components (current)

| Component | Purpose |
|-----------|---------|
| GraphRAG Knowledge Base | Create or connect a GraphRAG KB (AstraDB or ArangoDB) |
| GraphRAG Index Builder | Index documents into the knowledge model |
| GraphRAG Retrieve | Local / Global / DRIFT search |
| GraphRAG Maintain | Stats and clear (destructive) |
| GraphRAG Provenance | Entity ↔ TextUnit provenance lookup |

In the Langflow UI, open the **Liam** bundle or search for `GraphRAG` / `Liam`.

## Install

```bash
pip install lfx-liam-bundle
```

Requires Python **3.10+**. Runtime discovery uses the `langflow.extensions` entry-point (see [Langflow Extensions](https://docs.langflow.org/extensions-quickstart)).

Deploy into a local Langflow Docker container (optional):

```bash
./scripts/deploy-to-docker.sh
```

## GraphRAG module (summary)

Current GraphRAG support covers indexing (standard / FastGraphRAG), hierarchical communities, Local / Global / DRIFT retrieve, and vector ANN on AstraDB / ArangoDB.

Documentation index: **[docs/index.md](docs/index.md)**  
Upstream concepts: [Microsoft GraphRAG](https://microsoft.github.io/graphrag/)

## Development

```bash
mise exec -- uv sync
mise exec -- uv run pytest -m "not integration"
./devops/db-up.sh && ./devops/test-integration.sh   # optional real DB
```

See [docs/guides/install.md](docs/guides/install.md).

## License

[MIT](LICENSE)
