Dokumentation

Installation Options

Different ways to run Fabric AI - cloud hosted, Docker, or .NET Aspire for local development.

Fabric AI offers multiple deployment options depending on your needs. Choose the option that best fits your use case.

Deployment Options

Cloud Hosted (Recommended)

The fastest way to get started. No installation required—just sign up and start using Fabric AI immediately.

Best for: Most users, teams, and organizations

Docker Development

Run Fabric AI locally using Docker Compose. Great for development and testing.

Best for: Developers, contributors, customization

.NET Aspire

Unified orchestration for all services including agents. Advanced local development setup.

Best for: Advanced development, polyglot agents

The cloud-hosted version is the easiest way to use Fabric AI. No installation required.

Sign Up

Visit fabric.pro and create your account.

Configure AI Provider

Add your API key for OpenAI, Anthropic, or other supported providers.

Start Using

You're ready to go! Create agents, upload documents, and start generating content.

Advantages:

  • No setup or maintenance required
  • Automatic updates and new features
  • Enterprise-grade security and reliability
  • Managed infrastructure with 99.9% uptime

Docker Development Setup

For local development or testing, you can run Fabric AI using Docker.

Prerequisites

  • Docker Desktop (includes Docker and Docker Compose)
  • Node.js v20 or later
  • pnpm v10.14.0 or later

Quick Setup

Clone the Repository

git clone https://github.com/your-org/fabric-portal.git
cd fabric-portal

Start Docker Services

This starts PostgreSQL, Redis, Qdrant, Temporal, and MinIO:

docker-compose up -d

Install Dependencies

pnpm install

Configure MinIO Storage

Open http://localhost:9003 and log in with:

  • Username: minioadmin
  • Password: minioadmin

Create a bucket named avatars.

Initialize Database

Generate Prisma client and push schema:

pnpm --filter @repo/database generate
pnpm --filter @repo/database push

Seed Test Data (Optional)

Create test users for development:

pnpm --filter @repo/database seed

This creates admin users:

  • Email: raja.vemuri@techfabric.com / Password: Fabric!23
  • Email: preetham@techfabric.com / Password: Fabric!23

Start Development Server

pnpm dev

Open http://localhost:3001 in your browser.

Docker Services

ServicePortDescription
PostgreSQL5432Primary database
Redis6379Caching and sessions
Qdrant6333Vector database for RAG
Temporal7233Workflow engine
Temporal UI8233Temporal dashboard
MinIO9000S3-compatible storage
MinIO Console9003MinIO admin UI

Common Docker Commands

# Start all services
docker-compose up -d

# Stop all services
docker-compose down

# View logs
docker-compose logs -f

# Check service status
docker-compose ps

# Reset everything (destructive!)
docker-compose down -v

.NET Aspire Setup

.NET Aspire provides unified orchestration for all services, including TypeScript and Python agents.

Prerequisites

  • .NET 9 SDK (9.0.0 or later)
  • .NET Aspire 13 Templates
  • Docker Desktop
  • Node.js 20+ with pnpm

Install .NET Aspire

# Install Aspire templates
dotnet new install Aspire.ProjectTemplates --force

Quick Setup

Configure Aspire

cd aspire/Fabric.AppHost
cp appsettings.Development.json.example appsettings.Development.json

Edit appsettings.Development.json with your API keys and settings.

Run Everything

# Using native Aspire CLI (recommended)
cd aspire/Fabric.AppHost && dotnet run

# Or use the convenience script
./aspire.sh run

This starts all services automatically:

  • PostgreSQL, Redis, Qdrant, Temporal, MinIO
  • Prometheus, Grafana, Jaeger (observability)
  • LangGraph TypeScript agents
  • Next.js web application
  • Temporal worker
  • Aspire Dashboard

Access the Application

Stop Everything

Simply press Ctrl+C — containers stop automatically!

Aspire Commands

# Show container status
./aspire.sh status

# Restart all services
./aspire.sh restart

# Open Aspire Dashboard
./aspire.sh dashboard

# Clean everything (destructive!)
./aspire.sh clean

Aspire Advantages

  • Single command starts everything
  • Automatic cleanup when you stop
  • Unified observability with built-in dashboard
  • Polyglot support for TypeScript, Python, C# agents
  • Service discovery with automatic endpoint injection
  • Health monitoring for all services

Environment Variables

Key environment variables for all setups:

# Database
DATABASE_URL="postgresql://user:password@localhost:5432/fabric"

# AI Provider (required)
AI_GATEWAY_API_KEY="your-api-key"

# Vector Database (for RAG)
QDRANT_URL="http://localhost:6333"
QDRANT_COLLECTION_NAME="chat-documents"

# Temporal (for workflows)
TEMPORAL_ADDRESS="localhost:7233"
TEMPORAL_NAMESPACE="default"

# S3 Storage
S3_ACCESS_KEY_ID="minioadmin"
S3_SECRET_ACCESS_KEY="minioadmin"
S3_ENDPOINT="http://localhost:9000"

# Authentication
BETTER_AUTH_SECRET="your-secret-key"
BETTER_AUTH_URL="http://localhost:3001"

See .env.example for a complete list of environment variables.

Next Steps

Configure AI Provider

Set up OpenAI, Anthropic, or other AI providers

Create Your First Agent

Build a custom agent for your workflow

Connect External Tools

Set up MCP integrations with GitHub, Jira, Slack

On this page

Deployment OptionsCloud Hosted (Recommended)Sign UpConfigure AI ProviderStart UsingDocker Development SetupPrerequisitesQuick SetupClone the RepositoryStart Docker ServicesInstall DependenciesConfigure MinIO StorageInitialize DatabaseSeed Test Data (Optional)Start Development ServerDocker ServicesCommon Docker Commands.NET Aspire SetupPrerequisitesInstall .NET AspireQuick SetupConfigure AspireRun EverythingAccess the ApplicationStop EverythingAspire CommandsAspire AdvantagesEnvironment VariablesNext Steps