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, you'll need to install and configure the FiberWise command-line interface.

🔧 CLI Setup Required

For detailed installation instructions, including Python requirements, installation steps, and troubleshooting, please follow our comprehensive CLI setup guide:

Complete CLI Setup →

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:

  1. Open your browser to http://localhost:8000
  2. You'll see the FiberWise platform dashboard
  3. The default user account is automatically logged in
  4. 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