Core Concepts

Understand the Foundation of Fiberwise AI

Master the essential concepts that power the Fiberwise platform: intelligent agents, dynamic apps, real-time communication, and the activation processor system.

Learning Path

Master Fiberwise concepts in the right order for successful development

🏗️ Foundation Essential concepts to get started

📱
Step 1

Apps

Dynamic web applications with manifest-driven configuration, custom data models, and real-time WebSocket integration.

Explore Apps →
🤖
Step 2

Agents

Intelligent Python classes with automatic dependency injection and flexible execution patterns for building AI-powered functionality.

Learn about Agents →
⚙️
Step 3

Activation Processor

Core execution engine with pattern detection, service registry, and performance monitoring for agent execution.

Learn Activation Processor →

🗄️ Data & Storage Manage data, schemas, and security

🗄️

Dynamic Data Models

Manifest-driven database schema creation with field definitions, validation rules, and automatic API generation for CRUD operations.

Explore Data Models →
🛡️

User Isolation

Built-in security system ensuring data isolation between users with automatic enforcement and secure access controls.

Learn User Isolation →
📁

Storage Services

File upload, storage, and retrieval with multiple provider support and automatic organization.

Explore Storage →

🔗 Integration & Communication Connect with external services and real-time features

🧠

LLM Providers

Multi-provider system supporting OpenAI, Anthropic, Google AI with unified API and organization-level configuration.

Explore LLM Providers →
🔐

OAuth Integration

Secure authentication flows for integrating with Gmail, Slack, and other third-party services.

Learn OAuth →
🔄

Real-time Communication

WebSocket-based system with per-app connections, event broadcasting, and live activation updates.

Explore Real-time →

⚡ Advanced Automation, workflows, and system architecture

🔑

Agent API Keys

Enable autonomous access for distributed workers and third-party integrations. Unlock 24/7 automated workflows.

Learn Agent API Keys →
🔄

Workflows & Pipelines

Build complex multi-step processes with conditional logic, error handling, and automated execution.

Explore Workflows →
📦

Functions & Components

Serverless functions and reusable components for building modular, scalable applications.

Learn Functions →
📦

Entity Bundles

Reusable collections of agents, data models, and configurations that can be packaged, shared, and deployed across applications.

Learn Entity Bundles →

⚙️ Development & Integration Core development tools and integration patterns

🔗

AppBridge & SDK Integration

The bridge between your applications and the Fiberwise platform, providing seamless integration, data access, and real-time communication.

Learn AppBridge →
📡

Webhooks & Event System

Event-driven architecture enabling real-time integrations, automated workflows, and seamless communication with external services.

Explore Events →

Platform Architecture

Fiberwise employs a modular, service-oriented architecture designed for scalability, security, and developer productivity.

🎯 Application Layer

Frontend
Fiberwise Core Web FastAPI + Web Components dashboard for comprehensive platform management
CLI Interface Python-based command-line tools for development and deployment automation
Custom Applications User-built apps with JavaScript SDK integration and real-time capabilities

⚡ Processing Layer

Runtime
Activation Processor Intelligent agent execution engine with dependency injection and lifecycle management
Worker System Distributed background processing with horizontal scaling and fault tolerance
Pipeline Orchestrator Multi-agent workflow coordination with conditional logic and error handling

🔧 Service Layer

APIs
LLM Provider Integration Multi-provider AI services (OpenAI, Anthropic, Ollama) with intelligent routing
OAuth & Credentials Secure external service integration with token management and refresh handling
Real-time Communication WebSocket-based live updates, streaming responses, and event broadcasting
Dynamic Data Layer Schema-flexible data storage with powerful querying and relationship management

🗄️ Infrastructure Layer

Foundation
Cross-Database Support SQLite, PostgreSQL, DuckDB, MySQL, MariaDB with automatic query adapter for "write once, run anywhere" SQL
Security & Authentication Multi-layer auth (sessions, API keys, agent keys) with CSRF protection and CORS handling
Storage & Assets Configurable storage backends (local, S3, Azure) for applications and static assets
Monitoring & Logging Health checks, performance metrics, execution tracking, and comprehensive error handling

Key Architectural Principles

🔄
Microservices Ready Loosely coupled services with clear interfaces and independent scaling
🛡️
Security First Zero-trust architecture with comprehensive authentication and authorization
📈
Horizontally Scalable Container-ready with distributed processing and load balancing capabilities
🔌
Extensible Plugin architecture with comprehensive APIs and SDK integration points

Development Workflow

1

Install Platform

Set up Fiberwiselocally or connect to hosted instance with FastAPI backend and Web Components frontend.

2

Build Agents

Create Python agents with FiberAgent inheritance, dependency injection, and the activation processor system.

3

Create Apps

Develop dynamic apps with manifest-driven data models, Web Components UI, and real-time WebSocket integration.

4

Configure Providers

Set up LLM providers (OpenAI, Anthropic, Google AI) for agent intelligence and text generation capabilities.

5

Deploy & Scale

Package as entity bundles, deploy to production, and monitor with real-time activation updates.

Technology Stack

Backend

  • FastAPI (Python 3.8+)
  • SQLite/PostgreSQL
  • Uvicorn ASGI Server
  • WebSocket Support
  • JWT Authentication

Frontend

  • Vanilla JavaScript ES6+
  • Web Components
  • Vite Build System
  • Client-side Router
  • WebSocket Client

Agent System

  • Python SDK
  • Activation Processor
  • Dependency Injection
  • Entity Bundle System
  • Worker Management

Integration

  • REST API
  • WebSocket Events
  • OAuth 2.0
  • Multi-LLM Providers
  • File Storage