Metadata-Version: 2.4
Name: mgf-cloud-web
Version: 0.1.0
Summary: Magogi Foundation cloud console — a local single-user web GUI over mgf-cloud (Infomaniak Public Cloud first). FastAPI + Jinja, brand-styled. Sibling of mgf-cloud under the mgf.* namespace.
Project-URL: Homepage, https://codeberg.org/magogi-admin/mgf-cloud-web
Project-URL: Issues, https://codeberg.org/magogi-admin/mgf-cloud-web/issues
Project-URL: Changelog, https://codeberg.org/magogi-admin/mgf-cloud-web/src/branch/main/CHANGELOG.md
Author: Bassam Alsanie, mgf-cloud-web contributors
License: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: cloud,console,dashboard,fastapi,infomaniak,openstack
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: System :: Systems Administration
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: fastapi>=0.110
Requires-Dist: jinja2<4,>=3.1
Requires-Dist: mgf-brand-web<0.6,>=0.5
Requires-Dist: mgf-cloud[infomaniak]<0.2,>=0.1.3
Requires-Dist: mgf-common<1.0,>=0.47
Requires-Dist: mgf-fastapi<0.7,>=0.6
Requires-Dist: python-multipart>=0.0.9
Requires-Dist: uvicorn>=0.30
Provides-Extra: dev
Requires-Dist: httpx>=0.27; extra == 'dev'
Requires-Dist: import-linter>=2.0; extra == 'dev'
Requires-Dist: mgf-standard<0.2,>=0.1.6; extra == 'dev'
Requires-Dist: mgf-test-supervisor<0.2,>=0.1.3; extra == 'dev'
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest-timeout<3,>=2.3; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff<0.16,>=0.4; extra == 'dev'
Provides-Extra: standards
Requires-Dist: mgf-common[standards]<1.0,>=0.47; extra == 'standards'
Description-Content-Type: text/markdown

# 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.
