# mgf-cloud-web

The **Magogi Foundation cloud console** — a local, single-user web GUI for
viewing and managing cloud resources (Infomaniak Public Cloud first, any
provider `mgf-cloud` speaks). It is a thin, brand-styled front-end over the
[`mgf-cloud`](https://codeberg.org/magogi-admin/mgf-cloud) library: the provider,
cost, models, and credential-resolution layers all live in `mgf-cloud`; this
distribution owns only the FastAPI app, its routes, templates, and brand assets.

Sibling of `mgf-cloud` under the `mgf.*` namespace (PEP 420), matching
`mgf-cloud-provision`.

> **Scope:** a *local* operator tool — it binds `127.0.0.1`, has no auth, and is
> for a single user on their own machine. It is **not** a hosted multi-user
> service.

## Launch

```bash
mgf-cloud-web
```

Serves at <http://127.0.0.1:8787>. Credentials resolve exactly like `mgf-cloud`:
`--clouds-yaml` → `$MGF_CLOUD_CLOUDS_YAML` → `OS_*` env → a standard
`clouds.yaml` location, with `--cloud` selecting the entry (default `openstack`).

```bash
# pick a specific clouds.yaml entry / region
mgf-cloud-web --cloud PCP-HOESFJV-dc3-a
# bind elsewhere
mgf-cloud-web --host 127.0.0.1 --port 9000
# local dry test with no real cloud
mgf-cloud-web --provider fake
```

## Install

```bash
uv tool install --editable '.' \
  --index-url 'https://195.15.203.250.sslip.io/magogi/prod/+simple/'
```

## Relationship to mgf-cloud

`mgf-cloud` still ships its own `mgf-cloud web` command during the transition.
`mgf-cloud-web` is the refactored, brand-styled successor; once it is the default
launcher, the `[web]` extra in `mgf-cloud` will be deprecated.
