Rewrite Pods overview + choose-a-pod

docs/hub/overview.md

@@ -0,0 +1,99 @@
+---
+title: "Overview"
+description: "The RunPod Hub is a centralized repository for discovering, sharing, and deploying preconfigured AI repos optimized for RunPod's Serverless infrastructure."
+sidebar_position: 1
+---
+
+# RunPod Hub overview
+
+:::info
+
+The RunPod Hub is currently in **beta**. We're actively developing features and gathering user feedback to improve the experience. Please [join our discord](https://discord.gg/runpod) if you'd like to provide feedback.
+
+:::
+
+The RunPod Hub is a centralized repository that enables users to **discover, share, and deploy preconfigured AI repos** optimized for RunPod's [Serverless infrastructure](/serverless/overview/). It serves as a catalog of vetted, open-source repositories that can be deployed with minimal setup, creating a collaborative ecosystem for AI developers and users.
+
+Whether you're a developer looking to **share your work** or a user seeking **preconfigured solutions**, the Hub makes discovering and deploying AI projects seamless and efficient.
+
+<img src="/img/docs/hub-homepage.png" width="900" alt="Screenshot of the Hub page in the RunPod console"/>
+
+## Why use the Hub?
+
+The Hub simplifies the entire lifecycle of repo sharing and deployment, from initial submission through testing, discovery, and usage.
+
+### For RunPod users
+
+- **Find production-ready AI solutions**: Discover vetted, open-source repositories optimized for RunPod with minimal setup required.
+- **Deploy in one click**: Go from discovery to running services in minutes, not days.
+- **Customize to your needs**: RunPod Hub repos expose configurable parameters for fine-tuning without diving into code.
+- **Save development time**: Leverage community innovations instead of building from scratch.
+
+### For Hub creators
+
+- **Showcase your work**: Share your projects with the broader AI community.
+- **Maintain control**: Your GitHub repo remains the source of truth, while the Hub automatically detects new releases.
+- **Streamline your workflow**: Automated building and testing ensures your releases work as expected.
+
+## How it works
+
+The Hub operates through several key components working together:
+
+1. **Repository integration**: The Hub connects with GitHub repositories, using GitHub releases (not commits) as the basis for versioning and updates.
+2. **Configuration system**: Repositories use standardized configuration files (`hub.json` and `tests.json`) in a `.runpod` directory to define metadata, hardware requirements, and test procedures. See the [publishing guide](/hub/publishing-guide) to learn more.
+3. **Automated build pipeline**: When a repository is submitted or updated, the Hub automatically scans, builds, and tests it to ensure it works correctly on RunPod’s infrastructure.
+4. **Continuous release monitoring**: The system regularly checks for new releases in registered repositories and rebuilds them when updates are detected.
+5. **Deployment interface**: Users can browse repos, customize parameters, and deploy them to RunPod infrastructure with minimal configuration.
+
+## Getting started
+
+Whether you're a veteran developer who wants to share your work or a newcomer exploring AI models for the first time, the RunPod Hub makes getting started quick and straightforward.
+
+### Deploy a repo from the Hub
+
+You can deploy a repo from the Hub in seconds:
+
+1. Navigate to the [Hub page](https://www.runpod.io/console/hub) in the RunPod console.
+2. Browse the collection and select a repo that matches your needs.
+3. Review the repo details, including hardware requirements and available configuration options to ensure compatibility with your use case.
+4. Click the **Deploy** button in the top-right of the repo page. You can also use the dropdown menu to deploy an older version.
+5. Click **Create Endpoint**
+
+Within minutes you'll have access to a new Serverless endpoint, ready for integration with your applications or experimentation.
+
+### Publish your own repo
+
+Sharing your work through the Hub starts with preparing your GitHub repository with a working [Serverless endpoint](/serverless/overview) implementation, comprised of a [handler function](/serverless/handlers/overview) and `Dockerfile`. To learn how to create your first endpoint, [follow this guide](/serverless/get-started).
+
+Once your endpoint is ready to share:
+
+1. Add the required configuration files in a `.runpod` directory, following the instructions in the [Hub publishing guide](/hub/publishing-guide).
+2. Create a GitHub release to establish a versioned snapshot.
+3. Submit your repository to the Hub through the RunPod console, where it will undergo automated building and testing.
+4. The RunPod team will review your repo. After approval, your repo will appear in the Hub.
+
+To learn more, see the [Hub publishing guide](/hub/publishing-guide).
+
+## Use cases
+
+The RunPod Hub supports a wide range of AI applications and workflows. Here are some common use cases that demonstrate the versatility and power of Hub repositories:
+
+### For AI researchers and enthusiasts
+
+Researchers can quickly deploy state-of-the-art models for experimentation without managing complex infrastructure. The Hub provides access to optimized implementations of popular models like Stable Diffusion, LLMs, and computer vision systems, allowing for rapid prototyping and iteration. This accessibility democratizes AI research by reducing the technical barriers to working with cutting-edge models.
+
+### For individual developers
+
+Individual developers benefit from the ability to experiment with different AI models and approaches without extensive setup time. The Hub provides an opportunity to learn from well-structured projects. Repos are designed to optimize resource usage, helping developers minimize costs while maximizing performance and potential earnings.
+
+### For enterprises and teams
+
+Enterprises and teams can accelerate their development cycle by using preconfigured repos instead of creating everything from scratch. The Hub reduces infrastructure complexity by providing standardized deployment configurations, allowing technical teams to focus on their core business logic rather than spending time configuring infrastructure and dependencies.
+
+## Join the community
+
+The RunPod Hub is more than just a list of repos—it's a community of AI builders sharing knowledge and innovation.
+
+By participating, you'll connect with other developers facing similar challenges and discover cutting-edge implementations that solve problems you might be struggling with.
+
+Whether you're deploying your first model or sharing your twentieth repo, the Hub provides both the infrastructure and community connections to help you succeed.