Metadata-Version: 2.4
Name: kinenix-hub
Version: 0.2.0b2
Summary: Kinenix Hub: central server that receives worker heartbeats and execution logs, with a web dashboard and AI failure summaries
Author: arttopix
License-Expression: MIT
Project-URL: Homepage, https://github.com/arttopix/Kinenix
Project-URL: Documentation, https://github.com/arttopix/Kinenix/blob/main/docs/hub.md
Project-URL: Issues, https://github.com/arttopix/Kinenix/issues
Keywords: rpa,automation,dashboard,telemetry,local-ai
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Framework :: FastAPI
Classifier: Topic :: Office/Business
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: kinenix>=0.2.0b2
Requires-Dist: fastapi>=0.110.0
Requires-Dist: uvicorn[standard]>=0.28.0
Requires-Dist: sqlalchemy>=2.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: requests>=2.28.0
Requires-Dist: rich>=13.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: httpx>=0.27.0; extra == "dev"
Dynamic: license-file

# kinenix-hub

The **Kinenix Hub** is the central server of [Kinenix](https://github.com/arttopix/Kinenix), an open-source, local AI-native RPA framework in Python. Workers report to it, and you watch everything from one place.

> **Status: beta.** Job dispatch from the Hub to workers is planned; today workers run their own schedules and report to the Hub.

- Receives heartbeats from workers and shows each one as online, busy, or offline
- Stores every execution with its steps, timings, and errors (SQLite by default, any SQLAlchemy database through `DATABASE_URL`)
- Web dashboard, plus `kinenix hub status` and `kinenix hub logs` in the terminal
- AI failure summaries through a local model, so business data stays on your network
- Worker API key and dashboard login; listens on localhost only until you opt in

## Installation

```bash
pip install "kinenix[hub]"
```

This installs `kinenix-hub` together with `kinenix`, which provides the `kinenix hub` command. Requires Python 3.10 or newer.

## Usage

```bash
kinenix hub              # start; the first run asks a few setup questions and saves them
kinenix hub status       # workers and recent executions
kinenix hub logs         # steps of the latest execution
kinenix hub show-key     # the API key to give to workers
```

Settings are saved in `~/.kinenix/hub.env` and data in `~/.kinenix/hub.db`. On a worker machine, install `kinenix[worker]` and set `KINENIX_HUB_URL` and `KINENIX_HUB_API_KEY`.

## Documentation

- [Hub guide](https://github.com/arttopix/Kinenix/blob/main/docs/hub.md): setup, authentication, saved settings, and the API
- [Worker guide](https://github.com/arttopix/Kinenix/blob/main/kinenix-worker/README.md)
- [Project README](https://github.com/arttopix/Kinenix#readme)

## License

MIT
