# Charmed HPC

🚀 Charmed HPC is a next generation, open source cloud computing stack for supercomputers and
high-performance computing clusters ⚛️

```{warning}
Charmed HPC is currently in _pre-alpha_; some things might not work as expected.
Interested in being an early adopter? Please report any issues you have with
Charmed HPC on [GitHub](https://github.com/orgs/charmed-hpc/discussions/new?category=q-a&title=%5BISSUE%5D%3A+ADD+YOUR+ISSUE+HERE&body=*Please+describe+your+question+or+issue+with+Charmed+HPC*%0A%0A%0A%0A%0A---%0A*Redirected+from+document%3A+index.md*)!
```

---

## In this documentation


````{grid} 1 1 2 2

```{grid-item-card} [Tutorial](tutorial/first-steps)

__Start here__: a hands-on introduction to Charmed HPC for new users, guiding you through
your {ref}`first-steps`
```

```{grid-item-card} [How-to guides](howto/index)

__Step-by-step guides__ covering key operations and common tasks

- {ref}`howto-getstarted`
- {ref}`howto-observability`

```

````

````{grid} 1 1 2 2

```{grid-item-card} [Explanation](explanation/index)

__Discussion and clarification__ of key topics

🚧 Under construction 🚧

```


```{grid-item-card} [Reference](reference/index)

__Technical information__

🚧 Under construction 🚧

```

````

---

## Project and community

Charmed HPC is a project of the [Ubuntu High-Performance Computing
community](https://ubuntu.com/community/governance/teams/hpc).
Interested in contributing bug fixes, patches, documentation, or feedback?
Want to join the Ubuntu HPC community? You've come to the right place 🤩

Here's some links to help you get started with joining the community:

<!-- TODO: Add page with contributing guidelines. -->
<!-- TODO: Add page with more information on how to get support for Charmed HPC. -->

* [Ubuntu Code of Conduct](https://ubuntu.com/community/ethos/code-of-conduct)
* [Join the conversation on Matrix](https://matrix.to/#/#hpc:ubuntu.com)
* [Get the latest news on Discourse](https://discourse.ubuntu.com/c/hpc/151)
* [Ask and answer questions on GitHub](https://github.com/orgs/charmed-hpc/discussions/categories/q-a)

```{filtered-toctree}
:hidden:
:titlesonly:

self
Tutorial <tutorial/first-steps>
howto/index
explanation/index
reference/index
```