Free AI Server in the Cloud — No VPS Required
Turn GitHub Codespaces into your own personal AI backend.
No VPS. No Docker host. No monthly bill.
-white?logo=visualstudiocode&labelColor=007ACC){kind=icon}
If you've ever wanted a personal AI backend without paying for a VPS — this is it.
| 📑 Jump to |
|---|
| 🗺️ Architecture |
| 📚 Step-by-Step Guide |
| 📦 Repository Contents |
| ⚡ Quickstart |
| 📊 Free vs Pro |
What you'll learn:
- ✅ Create a free GitHub account + private repository
- ✅ Auto-install Hermes Agent with a single
.devcontainerconfig - ✅ Connect remotely from anywhere via Tailscale VPN — no public IP needed
- ✅ Run 24/7 within free-tier limits (120 core-hours/month)
💡 New to this? No problem. Every step is documented with examples. Built for absolute beginners.
flowchart TB
subgraph Local["🖥️ Your Computer"]
direction TB
Hermes["Hermes Desktop / CLI"]
TailLocal["Tailscale Client"]
end
subgraph Codespace["☁️ GitHub Codespace (Docker Container)"]
direction TB
DC[".devcontainer/postStart.sh"]
TS["tailscaled (daemon)"]
HS["hermes serve --port 9119"]
DC -->|"runs on start"| TS
DC -->|"runs on start"| HS
end
subgraph Tailnet["🔒 Tailscale Mesh VPN"]
IP["100.x.x.x (stable virtual IP)"]
end
TailLocal <-->|"WireGuard tunnel"| IP
IP <-->|"connects"| TS
Hermes -->|"http://100.x.x.x:9119"| HS
Hermes -->|"Auth: username + password"| HS
How it works: Codespace runs
hermes serve→ Tailscale assigns a stable IP → Your local machine connects via Tailscale → Hermes Desktop remotes to the Codespace.
| # | Part | Description | ⏱️ |
|---|---|---|---|
| 1 | Create a GitHub Account | Sign up for GitHub Free, verify email | 5 min |
| 2 | Create a Repository | Create a new private repo | 3 min |
| 3 | Set up .devcontainer | Create the Codespace configuration | 5 min |
| 4 | Configure Idle Timeout | Increase timeout before shutdown | 2 min |
| 5 | Create a Codespace | Launch and explore your Codespace | 3 min |
| 6 | Install Hermes & Connect Remote | Full setup: Hermes server + Tailscale + remote | 15 min |
| 7 | ⭐ Codespace CLI Management | Install gh CLI, create start/stop shortcuts, automate | 10 min |
flowchart LR
P1["1️⃣ Account"] --> P2["2️⃣ Repo"]
P2 --> P3["3️⃣ Config"]
P3 --> P4["4️⃣ Timeout"]
P4 --> P5["5️⃣ Codespace"]
P5 --> P6["6️⃣ Hermes + Tailscale"]
P6 --> P7["7️⃣ CLI"]
P7 --> Done["✅ COMPLETE"]
style P1 fill:#1f6feb,color:#fff
style P2 fill:#1f6feb,color:#fff
style P3 fill:#1f6feb,color:#fff
style P4 fill:#d29922,color:#fff
style P5 fill:#d29922,color:#fff
style P6 fill:#2ea043,color:#fff
style P7 fill:#2ea043,color:#fff
style Done fill:#2ea043,color:#fff,stroke:#7ee787,stroke-width:3px
codespaces-hermes-server/
├── .devcontainer/
│ ├── devcontainer.json # Config: calls postCreate.sh + postStart.sh
│ ├── postCreate.sh # Installs Hermes Agent (one-time)
│ └── postStart.sh # Starts Tailscale + Hermes serve (every restart)
├── docs/
│ ├── en/ # English guide (7 parts)
│ └── vi/ # Vietnamese guide (7 parts)
├── .gitignore
├── LICENSE # MIT License
├── SECURITY.md # Security policy
└── README.md # You are here
# 1. Create GitHub account + private repo
# 2. Add 3 files to .devcontainer/ (included in this repo)
# 3. Set idle timeout → 240 min in Settings → Codespaces
# 4. Create Codespace → wait for postCreate.sh to install Hermes + Tailscale
# 5. Inside Codespace — ONE-TIME Tailscale auth (only needed once):
sudo tailscale up # Opens browser to log in
tailscale ip # Save the 100.x.x.x IP
# 6. Create auth file
cat >> ~/.hermes/.env <<EOF
HERMES_DASHBOARD_BASIC_AUTH_USERNAME=admin
HERMES_DASHBOARD_BASIC_AUTH_PASSWORD=<your-strong-password>
HERMES_DASHBOARD_BASIC_AUTH_SECRET=$(openssl rand -base64 32)
EOF
chmod 600 ~/.hermes/.env
# 7. Restart Codespace → Hermes auto-starts
# 8. On local machine: Hermes Settings → Gateway → http://100.x.x.x:9119| Feature | GitHub Free | GitHub Pro |
|---|---|---|
| Private repos | ✅ Unlimited | ✅ Unlimited |
| Collaborators on private repos | ✅ Up to 3 | ✅ Unlimited |
| Codespaces (2-core) | ~60h uptime (120 core-hours) | 180 core-hours |
| GitHub Actions minutes/month | 2,000 min | 3,000 min |
For running a personal Hermes Agent backend, GitHub Free is more than enough.
⚙️ About machine type: When you create a Codespace, the default is 2 core — 8GB RAM. To change it after creation, go to https://github.com/codespaces → click
...(More actions) next to your Codespace → Change machine type. Free tier only offers 2 options: 2-core (8GB) or 4-core (8GB).
Mở hướng dẫn tiếng Việt — 7 phần, có ảnh minh họa
Dự án này cung cấp hướng dẫn chi tiết từ A đến Z để thiết lập Hermes Agent chạy trên GitHub Codespaces miễn phí, biến nó thành server cá nhân mà bạn có thể truy cập từ mọi nơi.
Bạn sẽ học cách:
- ✅ Tạo tài khoản GitHub và repository miễn phí
- ✅ Cấu hình
.devcontainerđể tự động cài Hermes Agent - ✅ Kết nối Codespace với máy local qua Tailscale VPN
- ✅ Chạy Hermes ở chế độ server — truy cập remote từ Hermes Desktop
- ✅ Quản lý core-hours và tối ưu chi phí
💡 Mới bắt đầu? Không sao! Hướng dẫn này dành cho cả người chưa từng dùng GitHub.
flowchart TB
subgraph Local["🖥️ Máy tính của bạn"]
direction TB
Hermes["Hermes Desktop / CLI"]
TailLocal["Tailscale Client"]
end
subgraph Codespace["☁️ GitHub Codespace (Docker Container)"]
direction TB
DC[".devcontainer/postStart.sh"]
TS["tailscaled (daemon)"]
HS["hermes serve --port 9119"]
DC -->|"khởi động khi start"| TS
DC -->|"khởi động khi start"| HS
end
subgraph Tailnet["🔒 Tailscale Mesh VPN"]
IP["100.x.x.x (IP ảo cố định)"]
end
TailLocal <-->|"WireGuard tunnel"| IP
IP <-->|"kết nối"| TS
Hermes -->|"http://100.x.x.x:9119"| HS
Hermes -->|"Auth: username + password"| HS
Cách hoạt động: Codespace chạy
hermes serve→ Tailscale gán IP cố định → Máy local kết nối qua Tailscale vào IP đó → Hermes Desktop remote về Codespace.
| # | Phần | Mô tả | ⏱️ |
|---|---|---|---|
| 1 | Tạo tài khoản GitHub | Đăng ký GitHub Free, xác thực email | 5 phút |
| 2 | Tạo Repository | Tạo repo private mới | 3 phút |
| 3 | Cấu hình .devcontainer | Tạo config chuẩn cho Codespace | 5 phút |
| 4 | Cấu hình Idle Timeout | Tăng thời gian chờ trước khi tắt | 2 phút |
| 5 | Tạo Codespace | Khởi tạo và làm quen với Codespace | 3 phút |
| 6 | Cài Hermes & Kết nối Remote | Setup Hermes server + Tailscale + remote connect | 15 phút |
| 7 | ⭐ Quản lý Codespace qua CLI | Cài gh CLI, tạo shortcut start/stop, tự động hoá | 10 phút |
flowchart LR
P1["1️⃣ GitHub"] --> P2["2️⃣ Repo"]
P2 --> P3["3️⃣ .devcontainer"]
P3 --> P4["4️⃣ Idle Timeout"]
P4 --> P5["5️⃣ Codespace"]
P5 --> P6["6️⃣ Hermes + Tailscale"]
P6 --> P7["7️⃣ CLI Management"]
P7 --> Done["✅ HOÀN TẤT"]
style P1 fill:#1f6feb,color:#fff
style P2 fill:#1f6feb,color:#fff
style P3 fill:#1f6feb,color:#fff
style P4 fill:#d29922,color:#fff
style P5 fill:#d29922,color:#fff
style P6 fill:#2ea043,color:#fff
style P7 fill:#2ea043,color:#fff
style Done fill:#2ea043,color:#fff,stroke:#7ee787,stroke-width:3px
codespaces-hermes-server/
├── .devcontainer/
│ ├── devcontainer.json # Config: gọi postCreate.sh + postStart.sh
│ ├── postCreate.sh # Cài Hermes Agent (1 lần)
│ └── postStart.sh # Khởi động Tailscale + Hermes serve (mỗi lần start)
├── docs/
│ ├── en/ # English guide (7 parts)
│ └── vi/ # Hướng dẫn tiếng Việt (7 phần)
├── .gitignore
├── LICENSE # MIT License
├── SECURITY.md # Chính sách bảo mật
└── README.md # Bạn đang ở đây
# 1. Tạo GitHub account + private repo
# 2. Thêm 3 file vào .devcontainer/ (có sẵn trong repo này)
# 3. Set idle timeout → 240 phút trong Settings → Codespaces
# 4. Tạo Codespace → đợi postCreate.sh cài Hermes + Tailscale
# 5. Trong Codespace — XÁC THỰC Tailscale 1 LẦN (chỉ cần làm 1 lần):
sudo tailscale up # Mở browser để đăng nhập
tailscale ip # Ghi lại IP 100.x.x.x
# 6. Tạo file auth
cat >> ~/.hermes/.env <<EOF
HERMES_DASHBOARD_BASIC_AUTH_USERNAME=admin
HERMES_DASHBOARD_BASIC_AUTH_PASSWORD=<your-strong-password>
HERMES_DASHBOARD_BASIC_AUTH_SECRET=$(openssl rand -base64 32)
EOF
chmod 600 ~/.hermes/.env
# 7. Restart Codespace → Hermes tự động online
# 8. Trên máy local: Hermes Settings → Gateway → http://100.x.x.x:9119| Tính năng | GitHub Free | GitHub Pro |
|---|---|---|
| Repo private | ✅ Không giới hạn | ✅ Không giới hạn |
| Cộng tác viên trên private repo | ✅ Tối đa 3 người | ✅ Không giới hạn |
| Codespaces (2-core) | ~60h uptime (120 core-hours) | 180 core-hours |
| GitHub Actions phút/tháng | 2,000 phút | 3,000 phút |
Với mục đích chạy Hermes Agent cá nhân, GitHub Free là hoàn toàn đủ.
⚙️ Về machine type: Khi tạo Codespace, mặc định là 2 core — 8GB RAM. Nếu muốn đổi, sau khi tạo Codespace xong, vào https://github.com/codespaces → click
...(More actions) bên cạnh Codespace → Change machine type. Chỉ có 2 tuỳ chọn trên Free: 2-core (8GB) hoặc 4-core (8GB).
Contributions are welcome! Please read CONTRIBUTING.md before submitting a pull request.
Found a vulnerability? See our Security Policy for reporting guidelines.
This project is licensed under the MIT License — see the LICENSE file for details.
⭐ Star this repo if you find it useful!
📧 skappafrost@gmail.com