Metadata-Version: 2.4
Name: hyperforge
Version: 1.0.0.post19
Summary: Agentic Framework for Orchestrated Runtime, Governance, and Execution
Author-email: AI Data Team <learning@nuclia.com>
License-Expression: Apache-2.0
Project-URL: Progress, https://progress.com
Project-URL: Github, https://github.com/nuclia/forge
Project-URL: API Reference, https://docs.rag.progress.cloud
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: alembic
Requires-Dist: pydantic
Requires-Dist: nuclia>=4.9.25
Requires-Dist: nuclia-models>=0.52.1
Requires-Dist: nucliadb-models>=6.13.1.post6414
Requires-Dist: nucliadb-sdk>=6.13.1.post6414
Requires-Dist: nucliadb-telemetry[otel]
Requires-Dist: pydantic_settings
Requires-Dist: mcp>=1.26.0
Requires-Dist: prometheus_client
Requires-Dist: mrflagly>=0.2.11
Requires-Dist: aiodns
Requires-Dist: httpx
Requires-Dist: jinja2
Requires-Dist: databases[asyncpg]
Requires-Dist: sqlalchemy
Requires-Dist: cryptography
Requires-Dist: mmh3
Requires-Dist: psycopg2
Requires-Dist: tenacity
Requires-Dist: websockets
Requires-Dist: redis[hiredis]>=6.4.0
Requires-Dist: types-redis>=4.6.0.20241004
Requires-Dist: ruff>=0.15.10
Requires-Dist: lru-dict
Requires-Dist: sentry_sdk
Requires-Dist: fastapi

# Hyperforge

Hyperforge is the core agentic workflow framework in this repository. It
provides the runtime, HTTP API, workflow orchestration, broker integration,
persistence layer, and support for loading Hyperforge agent packages.

## Install

From the workspace root:

```bash
uv sync
```

## Run

Start the API service:

```bash
uv run hyperforge-api
```

Useful endpoints:

- `/health/ready`
- `/health/alive`
- `/metrics`

## Configuration

Runtime configuration is provided through environment variables consumed by
Pydantic settings. Common settings include:

- `HTTP_HOST` and `HTTP_PORT`
- `MEMORY_READER_NUCLIADB`, `MEMORY_WRITER_NUCLIADB`, and
  `MEMORY_SEARCH_NUCLIADB`
- `MEMORY_APIKEY_NUCLIADB`
- `VALKEY_URL`
- `LOAD_MODULES`

## Development

Run the package tests from the workspace root:

```bash
uv run pytest hyperforge
```

Format and lint with the root `Makefile`:

```bash
make fmt
make lint
```
