Local Development Setup

The fastest way to get started with FiberWise. Perfect for learning, prototyping, and local development with no external dependencies.

�

Local Environment

Complete FiberWise platform running locally with SQLite database and web interface.

�

Development Server

Live development server with auto-reload for building and testing agents instantly.

🌐

Web Interface

Full-featured web UI at http://localhost:8000 for managing agents and applications.

Step 1: Install the FiberWise CLI

First, let's get the FiberWise command-line interface installed on your local machine.

1. Verify Your Python Version

FiberWise requires Python 3.8 or higher. Check your version:

python --version
# Expected output: Python 3.8.x or higher

💡 Note: If you don't have Python installed, download it from python.org.

2. Install FiberWise CLI

Install the FiberWise package using pip:

# Install the FiberWise CLI
pip install fiberwise

3. Verify the Installation

Check that the fiber command is available:

fiber --version
# Expected output: fiberwise, version x.y.z

✅ Success! The FiberWise CLI is now installed and ready to use.

Step 2: Initialize Your Local Environment

Initialize the FiberWise platform on your local machine. This sets up the database, downloads web components, and prepares your development environment.

1. Run the Initialize Command

Set up your local FiberWise environment:

fiber initialize

You'll see output like:

🚀 Initializing FiberWise platform...
📁 Step 0: Storage Configuration Setup
   ✅ Created/verified .fiberwise directory: C:\Users\[username]\.fiberwise
   ✅ Created storage directory: C:\Users\[username]\.fiberwise\app_uploads
   ✅ Created environment configuration: C:\Users\[username]\.fiberwise\.env

📋 Step 1: Database and Core Setup
   ✅ Database initialization completed successfully

🌐 Step 2: Web Components Setup
   � Cloning fiberwise-core-web from GitHub...
   ✅ Successfully cloned fiberwise-core-web
   📦 Installing Node.js dependencies...
   ✅ Node.js dependencies installed

🎉 FiberWise initialization completed successfully!

2. Understanding What Was Created

The initialize command created several important components:

📁 ~/.fiberwise Directory

Your local FiberWise data directory containing database, uploads, and configuration files.

🗄️ SQLite Database

Local database at ~/.fiberwise/fiberwise.db for storing agents, apps, and data.

🌐 Web Components

Frontend interface and API components for the web-based development environment.

👤 Default User Account

Local user account automatically created for accessing the web interface.

✅ Environment Ready! Your local FiberWise development environment is fully initialized.

Step 3: Start the Development Server

Launch the FiberWise development server to access the web interface and start building applications.

1. Start Development Mode

Launch the server with auto-reload and development features:

fiber start --dev

You'll see output like:

🚀 Development mode enabled (--dev)
Initializing database and seeding default user/app...
Database initialization completed successfully
� Starting Vite dev server on port 5556...
📱 Frontend dev server: http://localhost:5556
🖥️  Backend API server: http://localhost:8000
✅ FiberWise development server is running!

Open your browser to: http://localhost:8000

2. Access the Web Interface

Open your browser and navigate to the development server:

Open your browser to http://localhost:8000
You'll see the FiberWise platform dashboard
The default user account is automatically logged in
You can start creating agents and applications immediately

💡 Development Features: The --dev flag enables auto-reload, so any changes to your code will automatically refresh the interface.

3. Alternative: Production Mode

For testing the production build locally:

fiber start

This runs the server in production mode with built assets, similar to how it would run in deployment.

✅ Server Running! Your local FiberWise development environment is now accessible through the web interface.

🎉 Setup Complete! Verification Checklist

Let's verify that your local development environment is working correctly:

�

✅ Local Environment Initialized

Test: Check ~/.fiberwise directory exists

Your local FiberWise data directory should contain database, configuration files, and web components.

�

✅ Development Server Running

Test: http://localhost:8000 accessible in browser

You should see the FiberWise platform dashboard and be able to navigate the interface.

🌐

✅ Web Interface Active

Test: Default user automatically logged in

You should be able to access all features without additional authentication and start creating agents.

🚀 What's Next?

Now that you have your local development environment set up, you're ready to start building with Fiberwise:

� Immediate Next Steps

�

Build Your First App

Create a simple "Hello World" application to test your setup

15 min

🤖

Create AI Agents

Learn to build intelligent agents using LLM providers

30 min

📚 Learning Resources

🧠

Core Concepts

Understand the fundamental concepts that power Fiberwise

Read

📖

All Tutorials

Browse all available tutorials from beginner to advanced

Various

🔧 Quick Troubleshooting

❓ Port 8000 already in use

Stop other services using port 8000 or specify a different port:

fiber start --port 8080

❓ Changes not showing up

Make sure you saved the file and check the terminal for reload messages. If needed, restart with Ctrl+C then fiber start.

❓ AI provider not working

Verify your API key is correct and you have credits/quota remaining. Test with the fallback mode first.

❓ Need help?

Join our Discord community or check the troubleshooting guide for more help.