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:
- Main Interface: http://localhost:8000
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?
- Documentation: https://docs.fiberwise.ai
- GitHub Issues: Report bugs or request features
- Community Forum: Join the discussion
- Email Support: [email protected]