add initial documentation for available integrations

docs/inference-providers/_toctree.yml

@@ -28,6 +28,15 @@
   - local: guides/vscode
     title: VS Code with GitHub Copilot
 
+- title: Integrations
+  sections:
+  - local: intergrations/index
+    title: Integrations Overview
+  - local: intergrations/adding-integration
+    title: Add Your Integration
+  - local: intergrations/open-code
+    title: OpenCode
+
 - local: tasks/index
   title: Inference Tasks
   sections:

docs/inference-providers/intergrations/adding-integration.md

@@ -0,0 +1,59 @@
+# Add Your Integration
+
+Building a tool that works with Hugging Face Inference Providers? We'd love to feature it in our integrations directory!
+
+## Requirements
+
+To be listed, your integration should:
+
+- ✅ **Work with HF Inference Providers** via our API or OpenAI-compatible endpoints
+- ✅ **Be actively maintained** with recent commits or releases
+- ✅ **Have clear documentation** showing how to connect to HF
+
+## How to Submit
+
+1. **Test your integration** with Hugging Face Inference Providers
+2. **Fork the repository** at [github.com/huggingface/hub-docs](https://github.com/huggingface/hub-docs)
+3. **Add your integration page** in `docs/inference-providers/integrations/`
+4. **Update the index** in `docs/inference-providers/integrations/index.md`
+5. **Submit a Pull Request** with your changes
+
+## Integration Page Template
+
+Create a file named `your-tool-name.md` with this structure:
+
+```markdown
+# Your Tool Name
+
+Brief description of what your tool does.
+
+## Overview
+
+How your tool integrates with Hugging Face Inference Providers.
+
+## Prerequisites
+
+- Your tool installed
+- HF account with [API token](https://huggingface.co/settings/tokens)
+
+## Configuration
+
+Step-by-step setup instructions with code examples.
+
+## Resources
+
+- [Your Tool Documentation](https://yourtool.com/docs)
+- [HF Integration Guide](link-to-your-guide)
+```
+
+## Updating the Index
+
+Add your tool to the table in `integrations/index.md`:
+
+```markdown
+| [Your Tool](./your-tool) | Brief description | [Docs](https://yourtool.com/docs) | [Guide](../guides/your-guide) |
+```
+
+## Questions?
+
+Need help with your integration? Visit the [Hugging Face Forums](https://discuss.huggingface.co/) or open an issue in the [hub-docs repository](https://github.com/huggingface/hub-docs/issues).

docs/inference-providers/intergrations/index.md

@@ -0,0 +1,13 @@
+# Integrations
+
+Hugging Face Inference Providers integrates with a growing ecosystem of tools making it easy to use state-of-the-art models in your favorite development environments and workflows.
+
+## Available Integrations
+
+| Integration             | Description                            | Tool Documentation                                       | HF Guide                                                             |
+| ----------------------- | -------------------------------------- | -------------------------------------------------------- | -------------------------------------------------------------------- |
+| [OpenCode](./open-code) | AI coding agent built for the terminal | [Docs](https://opencode.ai/docs/providers/#hugging-face) | [GitHub Actions with OpenCode](../guides/github-actions-code-review) |
+
+## Adding Your Integration
+
+Building a tool that integrates with Hugging Face Inference Providers? We'd love to feature it! Check our [contribution guidelines](https://github.com/huggingface/hub-docs) for details on how to add your integration to this page.

docs/inference-providers/intergrations/open-code.md

@@ -0,0 +1,65 @@
+# OpenCode
+
+<div class="flex justify-center">
+    <a href="https://opencode.ai/" target="_blank">
+        <img class="block dark:hidden" src="https://opencode.ai/_build/assets/preview-opencode-wordmark-light-nzmKQT2r.png" alt="OpenCode">
+        <img class="hidden dark:block" src="https://opencode.ai/_build/assets/preview-opencode-wordmark-dark-tZ1Y3VXe.png" alt="OpenCode"/>
+    </a>
+</div>
+
+[OpenCode](https://opencode.ai/) is an AI coding agent built for the terminal that helps with code review, refactoring, testing, and general development tasks.
+
+## Overview
+
+OpenCode natively supports Hugging Face Inference Providers, giving you access to open models from 17+ providers through a single interface.
+
+## Prerequisites
+
+- OpenCode installed ([installation guide](https://opencode.ai/docs))
+- A Hugging Face account with [API token](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained) (needs "Make calls to Inference Providers" permission)
+
+## Configuration
+
+### Quick Setup
+
+1. Create a Hugging Face token with Inference Providers permissions at [huggingface.co/settings/tokens](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained)
+
+2. Run `opencode auth login` and select **Hugging Face**:
+
+```bash
+$ opencode auth login
+
+┌  Add credential
+│
+◆  Select provider
+│  ● Hugging Face
+│  ...
+└
+```
+
+3. Enter your Hugging Face token when prompted:
+
+```bash
+┌  Add credential
+│
+◇  Select provider
+│  Hugging Face
+│
+◇  Enter your API key
+│  hf_...
+└
+```
+
+4. Run the `/models` command in OpenCode to select a model.
+
+Once configured, OpenCode will use your selected model for all operations. You can switch models anytime using the `/models` command in the OpenCode TUI (Terminal User Interface).
+
+## GitHub Actions Integration
+
+OpenCode can also be used to run open models in GitHub Actions via Inference Providers. See our [GitHub Actions guide](../guides/github-actions-code-review) for setting up automated PR reviews.
+
+## Resources
+
+- [OpenCode Documentation](https://opencode.ai/docs)
+- [OpenCode Provider Configuration](https://opencode.ai/docs/providers/#hugging-face)
+- [GitHub Actions Integration Guide](../guides/github-actions-code-review)