# Hydron - AI-Powered Infrastructure Deployment Platform

> Deploy and manage cloud infrastructure with AI-powered automation. Paste a repository URL, pick a template, or describe what you need. AI handles servers, Docker, domains, SSL — everything.

For the complete documentation in a single file, see: https://hydron.app/llms-full.txt
For a machine-readable docs index: https://hydron.app/docs/index.json

## Quick Facts

- **Website**: https://hydron.app
- **App URL**: https://app.hydron.app
- **Documentation**: https://hydron.app/docs
- **MCP Server**: `npx hydron-mcp` (Model Context Protocol)
- **Free Credits**: Welcome bonus for new users, server costs separate
- **Target Users**: Developers who want to deploy applications without DevOps expertise

## What Hydron Does

Hydron is an AI-powered DevOps platform that automates the entire deployment lifecycle:

1. **Code Analysis**: AI analyzes your repository to detect frameworks, dependencies, and environment requirements
2. **Infrastructure Planning**: AI recommends optimal server configurations based on your application needs
3. **Automated Provisioning**: Dedicated servers are automatically provisioned
4. **Docker Configuration**: Automatic containerization with Docker and docker-compose
5. **Domain & SSL**: Automatic domain configuration and SSL certificate management via Let's Encrypt
6. **CI/CD Setup**: Automatic continuous deployment pipelines

## Supported Input Methods

1. **Git Repository URL**: Paste any public or private Git repository URL
2. **Docker Image**: Deploy from Docker Hub or any container registry
3. **Templates**: Choose from pre-built templates (Next.js, Express, FastAPI, Django, etc.)
4. **Natural Language**: Describe what you want to deploy

## Supported Technologies

Hydron supports any framework or language including:
- **Frontend**: React, Vue, Next.js, Nuxt, Svelte, SvelteKit, Astro, Gatsby
- **Backend**: Express, NestJS, FastAPI, Django, Flask, Rails, Spring Boot
- **Databases**: PostgreSQL, MySQL, MongoDB, Redis
- **Languages**: JavaScript/TypeScript, Python, Ruby, Java, Go, PHP

## MCP (Model Context Protocol) Integration

Hydron provides a comprehensive MCP server for AI agents to programmatically:

### Installation
```bash
npx hydron-mcp
```

### Environment Variables
- `HYDRON_API_URL` - Base URL for Hydron backend API
- `HYDRON_API_TOKEN` - Authentication token (obtain from app.hydron.app/settings)
- `HYDRON_DEVOPS_URL` - DevOps orchestrator URL
- `HYDRON_CODE_ANALYZER_URL` - Code analyzer service URL

### Available MCP Tools

**Code Analysis:**
- `analyze_repository` - Analyze a Git repository to detect stack and requirements
- `get_analysis_status` - Check analysis progress
- `get_analysis_result` - Get detailed analysis results

**Infrastructure:**
- `plan_infrastructure` - Generate infrastructure recommendations
- `get_server_offers` - List available server offerings with pricing
- `generate_provisioning_plan` - Create a detailed provisioning plan

**Inventory Management:**
- `list_servers` - List all managed servers
- `get_server_details` - Get detailed server information including SSH access
- `reboot_server` - Reboot a server
- `adopt_server` - Bring an external server under Hydron management
- `schedule_termination` - Schedule server termination

**Deployment:**
- `start_deployment` - Start a new deployment
- `get_deployment_status` - Check deployment progress
- `get_deployment_logs` - Stream deployment logs
- `list_runs` - List deployment runs

**Chat/Projects:**
- `list_projects` - List all projects
- `create_project` - Create a new project
- `list_chats` - List deployment chats
- `create_chat` - Start a new deployment conversation

## Pricing

- **Welcome Bonus**: Free credits for new users
- **AI Credits**: Credits-based pricing for AI features, top up as needed
- **Server Costs**: Infrastructure billed based on provisioned servers

## Key Differentiators

1. **Real Servers**: Unlike serverless platforms, apps run on dedicated servers with full SSH access
2. **No Vendor Lock-in**: Export your configuration and migrate anytime
3. **Full Control**: SSH access to your servers, full Docker control
4. **AI-First**: Natural language interface for deployment and management

## Getting Started

1. Visit https://hydron.app
2. Click "Start Building Free"
3. Sign up and get free credits to start
4. Paste your repository URL or choose a template
5. AI analyzes and deploys your application

## API Access

For programmatic access:
1. Create an account at https://app.hydron.app
2. Navigate to Settings > API Tokens
3. Generate an API token
4. Use with the MCP server or REST API

## Support

- **Documentation**: https://hydron.app/docs
- **Contact**: https://hydron.app/contact

## Documentation Pages

Individual doc pages are available as clean markdown at `/docs/{slug}.md`. The
documentation index page (lists all sections with links) is available as
markdown at:
- [Documentation Home](https://hydron.app/docs.md) - All sections and pages

(For programmatic consumption, a JSON index is also available at
https://hydron.app/docs/index.json — not a documentation page itself.)

### Getting Started
- [Introduction](https://hydron.app/docs/introduction.md) - What is Hydron and how does it work
- [Quick Start](https://hydron.app/docs/quick-start.md) - Deploy your first app in minutes
- [Key Concepts](https://hydron.app/docs/concepts.md) - Core concepts: projects, services, chats, plans

### Deploying
- [Deploy from Git](https://hydron.app/docs/deploy-from-git.md) - Deploy from GitHub, GitLab, Bitbucket, or any Git URL
- [Deploy a Docker Image](https://hydron.app/docs/deploy-docker.md) - Deploy an existing Docker image to your servers
- [Using Templates](https://hydron.app/docs/templates.md) - Quick-start with pre-configured templates

### Managing Your App
- [Projects](https://hydron.app/docs/projects.md) - Create, organize, and manage your projects
- [Services](https://hydron.app/docs/services.md) - Understanding and configuring services
- [Environment Variables](https://hydron.app/docs/environment-variables.md) - Setting and managing environment variables
- [Domains & SSL](https://hydron.app/docs/domains-ssl.md) - Custom domains and SSL certificates

### Infrastructure
- [How It Works](https://hydron.app/docs/how-it-works.md) - The full deployment pipeline explained
- [Code Analysis](https://hydron.app/docs/code-analysis.md) - How AI analyzes your codebase
- [Infrastructure Plans](https://hydron.app/docs/infrastructure-plans.md) - Understanding generated infrastructure plans
- [Server Provisioning](https://hydron.app/docs/server-provisioning.md) - How servers are provisioned and configured
- [Server Inventory](https://hydron.app/docs/server-inventory.md) - Browsing and managing your dedicated servers
- [Deployment Runs](https://hydron.app/docs/deployment-runs.md) - Monitoring and managing active deployments

### Account
- [Account Setup](https://hydron.app/docs/account-setup.md) - Registration, login, and OAuth
- [Security](https://hydron.app/docs/security.md) - Two-factor authentication and session management
- [Billing & Credits](https://hydron.app/docs/billing.md) - Credit system, usage tracking, and subscriptions

## Roadmap

Hydron publishes a public roadmap covering the next three months of
development, organized as Now / Next / Later with no fake deadlines. A plain
markdown version is available for agents at `/roadmap.md`.

- Roadmap: https://hydron.app/roadmap
- Roadmap (markdown): https://hydron.app/roadmap.md

## Blog

Hydron publishes engineering deep dives and infrastructure write-ups on the
blog. All posts are also available as plain markdown at `/blog/{slug}.md` and
the blog index is at `/blog.md`.

- Blog: https://hydron.app/blog
- Blog (markdown index): https://hydron.app/blog.md
- Blog (machine-readable index): https://hydron.app/blog/index.json
- Blog (RSS feed): https://hydron.app/blog/rss.xml

### Articles
- [From repo URL to production: a tour of Hydron's deployment pipeline](https://hydron.app/blog/from-repo-to-production-pipeline-tour.md) - How Hydron turns a paste-in Git URL into a live application on a dedicated server: three AI-driven planning stages, one orchestrated execution run, and what stays under your control.

## Links

- Homepage: https://hydron.app
- Application: https://app.hydron.app
- Documentation: https://hydron.app/docs
- Documentation (full text): https://hydron.app/llms-full.txt
- Documentation (index): https://hydron.app/docs/index.json
- Blog: https://hydron.app/blog
- Blog (RSS): https://hydron.app/blog/rss.xml
- Templates: https://hydron.app/templates
- Roadmap: https://hydron.app/roadmap
- About: https://hydron.app/about
- Terms: https://hydron.app/terms
- Privacy: https://hydron.app/privacy