Metadata-Version: 2.4
Name: ades-tool
Version: 0.2.3
Summary: Local-first semantic enrichment service and Python library.
Author: Bekir Dag
License: MIT
Requires-Python: >=3.11
Requires-Dist: build<2.0,>=1.2
Requires-Dist: fastapi<1.0,>=0.111
Requires-Dist: httpx<1.0,>=0.27
Requires-Dist: orjson<4.0,>=3.10
Requires-Dist: pydantic<3.0,>=2.7
Requires-Dist: twine<6.0,>=5.1
Requires-Dist: typer<1.0,>=0.12
Requires-Dist: uvicorn<1.0,>=0.30
Requires-Dist: wordfreq<4.0,>=3.1
Requires-Dist: zstandard<1.0,>=0.23
Provides-Extra: dev
Requires-Dist: mypy<2.0,>=1.10; extra == 'dev'
Requires-Dist: psycopg[binary,pool]<4.0,>=3.2; extra == 'dev'
Requires-Dist: pytest<9.0,>=8.2; extra == 'dev'
Requires-Dist: ruff<1.0,>=0.4; extra == 'dev'
Provides-Extra: server
Requires-Dist: psycopg[binary,pool]<4.0,>=3.2; extra == 'server'
Description-Content-Type: text/markdown

# ades

`ades` is a local-first semantic enrichment tool.

It installs small domain libraries, tags text or files locally, and can also run as a local HTTP service.

## Install

```bash
pip install ades-tool
# or
npm install -g @bekirdag/ades
```

The npm package is a thin wrapper around the Python runtime.

## Pull Libraries

Pull only the libraries you need:

```bash
ades pull general-en
ades pull finance-en
ades pull medical-en
ades pull finance-de-en
```

Current examples:

- `general-en`: shared English baseline
- `finance-en`: English finance entities
- `medical-en`: English medical entities
- `finance-de-en`: Germany public-market finance entities

Dependencies are pulled automatically.

## Tag Text

```bash
ades tag "NVIDIA reported earnings in Germany." --pack finance-en
```

Example response:

```json
{
  "pack": "finance-en",
  "entities": [],
  "topics": [],
  "warnings": [],
  "timing_ms": 12
}
```

`timing_ms` and the other response-time fields are in milliseconds.

## Run the Local Service

```bash
ades serve
```

Health check:

```text
GET /healthz
```

## More

- Detailed usage: [docs/usage.md](docs/usage.md)
- Production deployment: [docs/production_deployment.md](docs/production_deployment.md)
