🏗️ Al-Muassis (المؤسس) — AI Employee Platform

The Founder Agent — An AI-powered platform for Saudi businesses to automate operations, manage workflows, and scale intelligently.

✨ Features

🎨 Prestige UI

• Gold & Charcoal Theme — Elegant, professional interface
• Real-time Dashboard — Live monitoring of all systems
• Arabic-First Design — Native Arabic language support

🧠 Hive Mind

• Multi-Agent Coordination — Multiple AI agents working together
• Smart Routing — Automatic task distribution to the right agent
• Knowledge Graphs — Neo4j-powered knowledge management

📱 WhatsApp Integration

• Business Messaging — Full WhatsApp Business API integration
• Automated Responses — AI-powered customer service
• Multi-Tenant Support — Separate instances for each business

🔐 Enterprise-Ready

• Supabase Backend — Fast, scalable, secure
• OAuth & OTP Auth — Multiple authentication methods
• Billing & Subscriptions — Integrated payment system
• Approval Workflows — Human-in-the-loop decision making

🚀 Installation

Global Installation (CLI)

npm install -g @taseesai/muassis

Local Development

# Clone the repository
git clone https://github.com/taseesai/muassis-gateway.git
cd muassis-gateway

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

📖 Usage

CLI Commands

Start the Gateway

muassis start

This will:

• Start the Fastify server on http://localhost:3000
• Initialize knowledge graphs
• Display the Prestige-themed banner
• Open your browser to the dashboard

Initialize a Tenant

muassis init

Show Version

muassis version

Show Help

muassis help

Development Mode

# Watch mode with hot reload
npm run dev

# Build for production
npm run build

# Run built version
npm start

🔧 Configuration

Environment Variables

Create a .env file in the root directory:

# Server
PORT=3000
HOST=0.0.0.0
NODE_ENV=development
LOG_LEVEL=info

# Supabase
SUPABASE_URL=your_supabase_url
SUPABASE_ANON_KEY=your_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_key

# Model Providers
TOGETHER_API_KEY=your_together_key
GOOGLE_AI_API_KEY=your_google_key
DEEPSEEK_API_KEY=your_deepseek_key
OPENAI_API_KEY=your_openai_key

# WhatsApp
WHATSAPP_VERIFY_TOKEN=your_verify_token
WHATSAPP_ACCESS_TOKEN=your_access_token
WHATSAPP_PHONE_NUMBER_ID=your_phone_id
WHATSAPP_BUSINESS_ACCOUNT_ID=your_business_id

# Knowledge Graph
NEO4J_URI=bolt://localhost:7687
NEO4J_USER=neo4j
NEO4J_PASSWORD=your_password

# TTS (Optional)
AZURE_TTS_KEY=your_azure_key
AZURE_TTS_REGION=westeurope
ELEVENLABS_API_KEY=your_elevenlabs_key

🏗️ Architecture

┌─────────────────────────────────────────────────────────┐
│                    Al-Muassis Gateway                    │
│                    (Fastify Server)                      │
└─────────────────────────────────────────────────────────┘
                            │
        ┌───────────────────┼───────────────────┐
        │                   │                   │
        ▼                   ▼                   ▼
┌───────────────┐  ┌───────────────┐  ┌───────────────┐
│   WhatsApp    │  │    Auth &     │  │   Tenants &   │
│   Channels    │  │    Billing    │  │   Sessions    │
└───────────────┘  └───────────────┘  └───────────────┘
        │                   │                   │
        └───────────────────┼───────────────────┘
                            │
        ┌───────────────────┼───────────────────┐
        ▼                   ▼                   ▼
┌───────────────┐  ┌───────────────┐  ┌───────────────┐
│   Supabase    │  │    Neo4j      │  │  AI Models    │
│   (PostgreSQL)│  │ (Knowledge)   │  │(Together/Gem) │
└───────────────┘  └───────────────┘  └───────────────┘

📁 Project Structure

muassis-gateway/
├── src/
│   ├── agent/           # AI Agent implementations
│   ├── analytics/       # Analytics & reporting
│   ├── approval/        # Approval workflows
│   ├── arabic/          # Arabic NLP tools
│   ├── auth/            # Authentication
│   ├── billing/         # Billing & subscriptions
│   ├── channels/        # Communication channels
│   ├── cron/            # Scheduled tasks
│   ├── db/              # Database migrations
│   ├── gateway/         # Gateway routes
│   ├── integrations/    # Third-party integrations
│   ├── knowledge/       # Knowledge graphs
│   ├── media/           # Media handling
│   ├── memory/          # Memory management
│   ├── models/          # AI model wrappers
│   ├── onboarding/      # User onboarding
│   ├── rag/             # RAG implementations
│   ├── sessions/        # Session management
│   ├── skills/          # Agent skills
│   ├── tenants/         # Multi-tenancy
│   ├── tools/           # Tool definitions
│   ├── utils/           # Utilities
│   ├── cli.ts           # CLI entry point
│   ├── config.ts        # Configuration
│   └── index.ts         # Server entry point
├── dist/                # Built files
├── .env                 # Environment variables
├── .npmignore           # NPM ignore rules
├── package.json         # Dependencies & scripts
├── tsconfig.json        # TypeScript config
└── README.md            # This file

🎯 API Endpoints

| Endpoint | Method | Description | |----------|--------|-------------| | / | GET | API info & documentation | | /health | GET | Health check | | /api/auth/otp/send | POST | Send OTP for authentication | | /api/sessions | GET | List sessions | | /api/approvals/pending | GET | Get pending approvals | | /webhook/whatsapp | POST | WhatsApp webhook | | /api/tenants | GET | List tenants | | /api/billing/plans | GET | Get billing plans | | /api/onboarding/start | POST | Start onboarding | | /api/cron/jobs | GET | Run cron jobs |

🛠️ Development

Prerequisites

• Node.js >= 20.0.0
• PostgreSQL (via Supabase)
• Neo4j (for knowledge graphs)
• WhatsApp Business API account

Setup

# Install dependencies
npm install

# Copy environment template
cp .env.example .env

# Edit .env with your credentials

# Build the project
npm run build

# Run tests
npm test

# Start development server
npm run dev

📦 Publishing

Build for NPM

# Ensure all tests pass
npm test

# Build the project
npm run build

# Verify the build
npm run cli -- help

# Dry run (test publish)
npm publish --dry-run

Publish to NPM

# Login to NPM
npm login

# Publish (first time)
npm publish

# Publish new version
npm version patch
npm publish

Note: The package is scoped as @taseesai/muassis, so you need publish access to the @taseesai organization on NPM.

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

UNLICENSED — All rights reserved by TaseesAI.

📞 Support

• Email: [email protected]
• Website: https://taseesai.com
• Location: Jeddah, Saudi Arabia

🙏 Acknowledgments

• TaseesAI Team — Building the future of AI in Saudi Arabia
• Supabase — Open-source Firebase alternative
• Fastify — Fast and low overhead web framework
• Together AI — LLM inference platform
• WhatsApp Business API — Business messaging

Al-Muassis — Because every successful business needs a founder who never sleeps. 🏗️