Getting Started with Fiberwise

Get up and running with the Fiberwise AI platform in minutes. This guide will walk you through installation, configuration, and your first agent activation.

Overview

Fiberwise is a comprehensive AI-powered platform for building intelligent applications with agent systems, LLM providers, and workflow automation. The platform provides:

  • Agent-First Architecture: Build intelligent applications with AI agents that think and act
  • Multi-Provider LLM Support: Connect OpenAI, Anthropic, Google AI, and more
  • Visual Workflow Designer: Drag-and-drop pipeline editor with conditional logic
  • Rich App Ecosystem: Pre-built applications for immediate productivity
  • Enterprise Security: Role-based access control and encrypted storage

System Requirements

Minimum Requirements

Operating System

  • Windows 10/11 (x64)
  • macOS 10.15+ (Intel or Apple Silicon)
  • Linux (Ubuntu 20.04+, CentOS 8+)

Software

  • Python (Required)
  • Node.js 16+ (Required for web interface)
  • Git (Required for installation)

Hardware

  • 4GB RAM minimum (8GB recommended)
  • 2GB available disk space
  • Internet connection

Recommended for Production

  • Hardware: 8GB+ RAM, 4+ CPU cores, SSD storage
  • Database: PostgreSQL 12+ (SQLite included for development)
  • Network: Ports 8000, 5555 available, HTTPS access for LLM providers

Installation

Quick Install (Recommended)

The fastest way to get started with Fiberwise:

1. Install Fiberwise platform

pip install fiberwise

2. Initialize database and web components

fiber setup

3. Start the platform

fiber start

✅ What this does:

  • Installs the core Fiberwise platform
  • Sets up SQLite database with required tables
  • Downloads and builds web interface components
  • Creates default user account
  • Starts web server on http://localhost:8000

Development Installation

For developers who want to contribute or customize the platform:

# Clone the repository
git clone https://github.com/fiberwise-ai/fiberwise.git
cd fiberwise

# Install in development mode
pip install -e .

# Install development dependencies
pip install -e ".[test]"

# Initialize platform
fiber setup

# Start in development mode
fiber start --dev

Production Installation

For production deployments with PostgreSQL:

# Install core platform
pip install fiberwise

# Install production dependencies
pip install fiberwise-common[postgres]

# Set environment variables
export FIBERWISE_DATABASE_URL="postgresql://user:pass@localhost/fiberwise"
export FIBERWISE_SECRET_KEY="your-secret-key-here"

# Initialize with PostgreSQL
fiber setup --database-url $FIBERWISE_DATABASE_URL

# Start production server
fiber start --port 80 --workers 4

Configuration

Environment Variables

Configure Fiberwise using environment variables:

Variable Description Default
FIBERWISE_DATABASE_URL Database connection URL sqlite:///~/.fiberwise/fiberwise.db
FIBERWISE_SECRET_KEY Secret key for security Auto-generated
FIBERWISE_WEB_PORT Web interface port 8000
FIBERWISE_CORE_PORT Core API port 5555

Configuration File

Create ~/.fiberwise/config.json for advanced configuration:

{
  "database": {
    "url": "sqlite:///~/.fiberwise/fiberwise.db",
    "type": "sqlite"
  },
  "web": {
    "port": 8000,
    "host": "0.0.0.0"
  },
  "storage": {
    "provider": "local",
    "path": "~/.fiberwise/storage"
  },
  "llm_providers": {
    "default": "openai"
  }
}

First Steps

1. Verify Installation

# Check platform status
fiber status

Expected output:

✓ Database initialized
✓ User account created
✓ Web components ready
✓ Platform operational

2. Access Web Interface

Open your browser and navigate to:

3. Configure LLM Providers

Add your preferred AI providers:

# Add OpenAI provider
fiber provider add openai --api-key "your-openai-api-key"

# Add Anthropic provider
fiber provider add anthropic --api-key "your-anthropic-api-key"

4. Test Agent Activation

Create and test your first agent:

# Create test agent
echo 'def test_agent(input_data): return {"status": "success", "message": "Hello World"}' > test_agent.py

# Activate agent
fiber activate --input-data '{}' test_agent.py

🎉 Success!

If you see a successful response, your Fiberwise platform is ready to use!

Next Steps

Need Help?