Quick Start

📋 Prerequisites: Your Setup Checklist

Before diving into your first agent, make sure you have completed these setup steps:

# Check Python version

# Check Fiberwise CLI
fiber --version
# Should show the Fiberwise version number

# Test CLI configuration
fiber account status
# Should show your configured instance details

Step 1: Set Up FiberWise

FiberWise is a local development platform. Set up your environment by navigating to your Fiberwise installation directory:

# Navigate to your Fiberwise installation
cd path/to/fiberwise

# Install Python dependencies
pip install -r requirements.txt

Verify the setup by checking the directory structure:

# List the main components
ls -la
# You should see: fiber-apps/, fiberwise/, fiberwise-core-web/, etc.

Step 2: Start the Platform

Start the FiberWise web platform:

# Start the web platform (from fiberwise-core-web directory)
cd fiberwise-core-web
python main.py

🚀 Initializing FiberWise platform...
📁 Step 0: Storage Configuration Setup
📋 Step 1: Database and Core Setup
🌐 Step 2: Web Components Setup
🎉 FiberWise initialization completed successfully!

Step 3: Create Your First Agent

Create a simple agent that processes text input. Create a new file called my_first_agent.py:

# my_first_agent.py
async def run_agent(input_data, fiber, llm_service):
    """
    A simple text processing agent.
    
    Args:
        input_data (dict): Input containing 'text' to process
        fiber: FiberWise platform interface
        llm_service: LLM provider (optional)
        
    Returns:
        dict: Response with processed text and analysis
    """
    text = input_data.get('text', 'Hello, World!')
    
    # Simple text analysis
    word_count = len(text.split())
    char_count = len(text)
    
    # If LLM service is available, get AI analysis
    ai_analysis = "No AI provider configured"
    if llm_service:
        try:
            prompt = f"Analyze this text in one sentence: {text}"
            response = await llm_service.generate_completion(prompt=prompt)
            ai_analysis = response.get('text', 'AI analysis failed')
        except Exception as e:
            ai_analysis = f"AI analysis error: {str(e)}"
    
    return {
        'status': 'success',
        'original_text': text,
        'word_count': word_count,
        'character_count': char_count,
        'ai_analysis': ai_analysis,
        'agent_name': 'My First Agent',
        'message': '🎉 Your first agent is working!'
    }

Step 4: Test Agent Instantly (Local Client)

Test your agent immediately using FiberWise's local client. This runs without starting the full platform:

# Run agent directly using local client (no background services needed)
fiber activate my_first_agent.py --input-data '{"text": "FiberWise is amazing!"}'

Expected Output:

{
  "status": "success",
  "original_text": "FiberWise is amazing!",
  "word_count": 3,
  "character_count": 20,
  "ai_analysis": "No AI provider configured",
  "agent_name": "My First Agent",
  "message": "🎉 Your first agent is working!"
}

Step 5: Start the Platform (See Activity History)

Now let's start the full platform to see your agent activation recorded in the web interface:

# Start the platform in development mode
fiber start --dev

🚀 Development mode enabled (--dev)
Database initialization completed successfully
🌐 Starting Vite dev server on port 5556...
✅ FiberWise development server is running!

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

Step 6: Explore Both Modes

fiber activate agent.py --input-data '{...}'

fiber start --dev

Step 7: Explore the Web Interface

🎉 What's Next?

Troubleshooting

# Reinstall FiberWise
pip install --upgrade fiberwise

# Check if it's in your PATH
which fiber  # On Unix/Mac
where fiber  # On Windows

# Use a different port
fiber start --dev --port 8080

# Or stop the conflicting service
# On Windows: netstat -ano | findstr :8000
# On Unix/Mac: lsof -i :8000

# Force re-initialization
fiber initialize --force

# Or if that fails, try:
fiber initialize --force-clone

# Test Python syntax
python -m py_compile my_first_agent.py