Skip to content

Commit 4a4bc89

Browse files
Merge pull request #113 from sensein/tekrajchhetri-patch-3
Updated readme to include architecture diagram
2 parents 1b5ebc2 + b8c81ee commit 4a4bc89

1 file changed

Lines changed: 28 additions & 2 deletions

File tree

README.md

Lines changed: 28 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,28 @@
22

33
`structsense` is a multi-agent system for extracting structured information from unstructured text and documents. It orchestrates a configurable pipeline of AI agents — extractor → alignment → judge → human feedback — each driven by a single YAML config file.
44

5-
**Documentation:** [docs.brainkb.org](http://docs.brainkb.org/structsense_overview.html)
65
**License:** [Apache 2.0](LICENSE.txt)
76

7+
If you find this work useful or build upon it, please consider citing:
8+
9+
```bibtex
10+
@misc{chhetri2025structsensetaskagnosticagenticframework,
11+
title = {STRUCTSENSE: A Task-Agnostic Agentic Framework for Structured Information Extraction with Human-In-The-Loop Evaluation and Benchmarking},
12+
author = {Tek Raj Chhetri and Yibei Chen and Puja Trivedi and Dorota Jarecka and Saif Haobsh and Patrick Ray and Lydia Ng and Satrajit S. Ghosh},
13+
year = {2025},
14+
eprint = {2507.03674},
15+
archivePrefix= {arXiv},
16+
primaryClass = {cs.CL},
17+
url = {https://arxiv.org/abs/2507.03674}
18+
}
19+
```
20+
821
---
922

1023
## Table of Contents
1124

1225
- [Features](#features)
26+
- [Architecture](#architecture)
1327
- [Installation](#installation)
1428
- [Quick Start](#quick-start)
1529
- [Usage](#usage)
@@ -46,6 +60,18 @@
4660

4761
---
4862

63+
## Architecture
64+
65+
The figure below illustrates the overall architecture of **StructSense**.
66+
67+
68+
<img width="2571" height="823" alt="with_arch_search-with_search_api drawio (1)" src="https://github.com/user-attachments/assets/8f652c10-4301-4193-b1c8-f750229f972c" />
69+
70+
StructSense integrates a local concept mapping service, which can also be used independently. The service is available here:
71+
- https://github.com/sensein/search_hybrid
72+
73+
---
74+
4975
## Installation
5076

5177
```bash
@@ -464,7 +490,7 @@ By default (`skip_alignment_llm=None`), the alignment LLM is **automatically byp
464490
- `CONCEPT_MAPPING_BACKEND=local` (which is the default)
465491
- Task type is `ner`, `keyphrase_extraction`, `resource`, or `structured_extraction`
466492

467-
When bypassed, the concept mapping tool is called directly from Python in one batch (4000 concept/request--see [https://github.com/sensein/search_hybrid/tree/dev](https://github.com/sensein/search_hybrid/tree/dev)) — much
493+
When bypassed, the concept mapping tool is called directly from Python in one batch (4000 concept/request--see [https://github.com/sensein/search_hybrid](https://github.com/sensein/search_hybrid)) — much
468494
faster than running the LLM. The output records `alignment_method: "direct_tool_call"`.
469495
470496
```bash

0 commit comments

Comments
 (0)