TFGrid Studio Documentation¶

Complete development platform for ThreeFold Grid

Build, deploy, and scale decentralized applications with tfgrid-compose CLI and integrated tools.

🌐 New here? Check out our main website for an overview of TFGrid Studio, pricing, and features.

🎯 What is TFGrid Studio?¶

TFGrid Studio is a complete development platform for ThreeFold Grid. The flagship tool, tfgrid-compose, brings docker-compose-style simplicity to decentralized deployments.

# Deploy any application with one command
tfgrid-compose up my-app

No vendor lock-in. Industry standards. Decentralized infrastructure.

🚀 Quick Start¶

1. Install tfgrid-compose¶

# One-line installer
curl -sSL install.tfgrid.studio/install.sh | sh

# Verify installation
tfgrid-compose --version

2. Set Up ThreeFold¶

Need a ThreeFold wallet with TFT? See the complete setup guide.

Already have a wallet? Configure it:

tfgrid-compose login
# Enter your seed phrase when prompted

3. Deploy an App¶

# Deploy official app (v0.10.0+)
tfgrid-compose up tfgrid-ai-agent

# Or use local path (current)
tfgrid-compose up ../tfgrid-ai-agent

# Or specify app path
tfgrid-compose up ../tfgrid-ai-agent

That's it! Your application is now running on ThreeFold Grid. 🎉

📚 Where to go next¶

1. New to TFGrid Studio?¶

Introduction – what TFGrid Studio and tfgrid-compose are.
Installation – install and configure tfgrid-compose.
ThreeFold Setup – wallet, TFT, and account setup.
Quick Start – deploy your first application in a few minutes.

2. Prefer a visual dashboard?¶

TFGrid Dashboard – GUI alternative to the CLI for apps, deployments, and commands.
TFGrid AI Stack – full AI workspace (dashboard, agent, and Gitea).

3. Need more depth?¶

Guides – product and workflow guides for TFGrid Compose and apps.
Deployment patterns – single‑VM, gateway, and k3s patterns.
CLI reference – detailed commands and flags.

4. Building on top of TFGrid Studio?¶

Submit your app – share apps with the community.
Pattern contract – how patterns communicate.
Architecture overview – how the system fits together.

🎯 Use Cases¶

Deploy isolated AI coding environments on ThreeFold Grid.

tfgrid-compose up tfgrid-ai-agent

Web Applications¶

Deploy web apps with public IPv4, SSL, and reverse proxy.

tfgrid-compose up my-webapp --pattern=gateway --domain=myapp.com

Cloud-Native Apps¶

Deploy microservices on Kubernetes clusters.

tfgrid-compose up my-saas --pattern=k3s

Databases¶

Deploy databases with persistent storage and private networking.

tfgrid-compose up my-postgres --pattern=single-vm

💡 Why TFGrid Compose?¶

✅ No Vendor Lock-in¶

Uses industry standards: Terraform, Ansible, Kubernetes. Your apps aren't locked to ThreeFold Grid.

✅ Simple & Powerful¶

Heroku-like UX with production-ready patterns. One command to deploy, full control when needed.

✅ Decentralized Infrastructure¶

Runs on ThreeFold Grid: decentralized compute, no single point of failure, cost-effective.

✅ Open Source¶

Apache 2.0 license. Free to use, modify, and distribute. Community-driven development.

✅ Battle-Tested¶

Built from ThreeFold open-source proven, working code implementations: - Gateway pattern: Based on mik-tf/tfgrid-gateway - K3s pattern: Based on ucli-tools/tfgrid-k3s - AI agent: Based on mik-tf/tfgrid-ai-agent