Metadata-Version: 2.5
Name: yhub
Version: 0.0.1
Summary: Name reservation for yhub — an always-on local hub for your own machines and services.
Project-URL: Homepage, https://github.com/ifeitao/yhub
Project-URL: Repository, https://github.com/ifeitao/yhub
Project-URL: Issues, https://github.com/ifeitao/yhub/issues
Author: Yifeitao
License-Expression: MIT
License-File: LICENSE
Keywords: cli,dashboard,homelab,mcp,monitoring,self-hosted
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Console
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# yhub

**This is a name-reservation release (`0.0.1`).** It reserves the distribution name `yhub` on
PyPI and does nothing else.

The real package — **an always-on local hub for your own machines, services and pipelines**
(CLI + web dashboard + MCP server, installed from a single wheel) — is planned for **2027**.

Nothing in this repository is a working product yet. Please don't build on it.

## What the real release will be

- **Information surface**: a wall of status cells (services, sync pipelines, scheduled jobs,
  mounts) you keep on screen, each cell a three-state reading — fresh / stale / failing.
- **Action surface**: buttons, toggles and inputs on those same cells, so a cell can *do*
  something, not just report.
- **Three faces from one declaration**: every capability is declared once and generated into a
  CLI command, an HTTP route and an MCP tool.
- **Local by default**: binds `127.0.0.1` only; reads the machine it runs on (local daemons,
  mounts, files), not a cloud account.

## Verify the install

```bash
uv tool install yhub
yhub --version          # -> yhub 0.0.1
```

or without installing anything:

```bash
uv run --no-project --with yhub python -m yhub --version
```

## License

MIT — see [LICENSE](LICENSE).
