Documentation

Project Noir Documentation

Everything you need to build, deploy, and scale AI-powered multi-channel outreach. Project Noir replaces your outreach team with AI agents that call, message on Telegram, and email your leads.

Quick Start

Get up and running with Project Noir in minutes.

Architecture

Understand the system design, services, and data flows.

API Reference

Complete reference for all 37 API endpoints.

Deployment

Deploy to Vercel and Railway with environment configuration.

System Architecture

                     +---------------------+
                     |   Landing Page      |
                     |   (Vercel)          |
                     +---------+-----------+
                               |
                               v
+------------------------------------------------------------------+
|                       Next.js Dashboard                          |
|                       (Vercel)                                   |
|                                                                  |
|  Campaigns | Leads | Scripts | Voice | Telegram | Email | Billing|
+-----+---------------------------+-------------------+------------+
      |                           |                   |
      v                           v                   v
+-------------+          +----------------+    +-------------+
| Neon        |<---------| Voice Agent    |    | Telegram    |
| PostgreSQL  |          | (Railway)      |    | Worker      |
|             |<---------|                |    | (Railway)   |
+-------------+          | Pipecat +      |    |             |
      ^                  | Deepgram STT + |    | Telethon +  |
      |                  | GPT-4o +       |    | FastAPI     |
      |                  | ElevenLabs TTS |    +------+------+
      |                  +-------+--------+           |
      |                          |                    |
      +--------------------------+--------------------+
                                 |
                          +------+------+
                          |   Twilio    |
                          |  (Voice)    |
                          +-------------+

Channels

Voice Calls

AI voice agents powered by Pipecat, Deepgram, and ElevenLabs.

Automated Telegram outreach with account pooling.

Email

AI-generated emails sent through Resend.

Tech Stack

Layer	Technology
Landing + Dashboard	Next.js 16, TypeScript, Tailwind CSS v4, shadcn/ui, Framer Motion
Authentication	Clerk
Database	Neon PostgreSQL (serverless) + Drizzle ORM
Voice Agent	Python 3.11, Pipecat, Deepgram Nova-3 STT, GPT-4o, ElevenLabs TTS
Telegram Worker	Python 3.11, Telethon, FastAPI, Uvicorn
Email	Resend
Payments	Stripe (international) + LiqPay (Ukraine)
Telephony	Twilio
Hosting	Vercel (web app) + Railway (Python services)