Initial release — open-source AgentLine telephony API

AI-native telephony platform giving AI agents real phone numbers,
voice calls, SMS, and MCP server integration.

Features:
- FastAPI REST API with full CRUD for agents, calls, numbers, SMS
- Built-in voice pipeline: Deepgram STT + Cartesia TTS + OpenAI LLM
- MCP server for Claude Desktop and Cursor integration
- Skill file for one-file AI agent install
- Event mailbox for poll-based event consumption
- Per-second billing with balance tracking
- Docker Compose for local development
- Railway deployment support

MIT License

Author: Sameersribot

.env.example

@@ -0,0 +1,35 @@
+# AgentLine Environment Variables
+# Copy this file to .env and fill in your values
+# See: https://github.com/agentlineHQ/AgentLine#configuration
+
+# ── Database (Supabase) ──────────────────────────────────────
+SUPABASE_URL=https://your-project.supabase.co
+SUPABASE_ANON_KEY=your-supabase-anon-key
+SUPABASE_SERVICE_ROLE_KEY=your-supabase-service-role-key
+
+# Get from: Supabase Dashboard → Settings → Database → Connection string → URI
+DATABASE_URL=postgresql://postgres:password@host:5432/postgres
+
+# ── Redis (optional) ─────────────────────────────────────────
+REDIS_URL=redis://localhost:6379/0
+
+# ── Telephony Provider (SignalWire) ──────────────────────────
+# Sign up at https://signalwire.com
+SIGNALWIRE_PROJECT_ID=your_project_id
+SIGNALWIRE_TOKEN=your_api_token
+SIGNALWIRE_SPACE_URL=your-space.signalwire.com
+
+# ── Voice Pipeline ───────────────────────────────────────────
+# Deepgram — speech-to-text (https://deepgram.com)
+DEEPGRAM_API_KEY=your-deepgram-key
+
+# Cartesia — text-to-speech (https://cartesia.ai)
+CARTESIA_API_KEY=your-cartesia-key
+
+# OpenAI — LLM for voice conversations (https://openai.com)
+OPENAI_API_KEY=your-openai-key
+
+# ── App ──────────────────────────────────────────────────────
+SECRET_KEY=generate-a-random-string-here
+BASE_URL=http://localhost:8000
+WEBHOOK_SECRET_SALT=generate-a-random-string-here

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,36 @@
+---
+name: Bug Report
+about: Report a bug to help us improve AgentLine
+title: "[Bug] "
+labels: bug
+assignees: ''
+---
+
+## Describe the Bug
+
+A clear description of what the bug is.
+
+## Steps to Reproduce
+
+1. Make a request to `...`
+2. With payload `...`
+3. Observe error `...`
+
+## Expected Behavior
+
+What you expected to happen.
+
+## Actual Behavior
+
+What actually happened. Include error messages, status codes, or logs.
+
+## Environment
+
+- **OS:** (e.g., Ubuntu 22.04, macOS 14, Windows 11)
+- **Python version:** (e.g., 3.12.4)
+- **AgentLine version/commit:** (e.g., `main` branch, commit `abc123`)
+- **Deployment:** (Docker, local, Railway, etc.)
+
+## Additional Context
+
+Any other context, screenshots, or log output.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,27 @@
+---
+name: Feature Request
+about: Suggest a new feature for AgentLine
+title: "[Feature] "
+labels: enhancement
+assignees: ''
+---
+
+## Problem
+
+What problem does this feature solve? What limitation are you running into?
+
+## Proposed Solution
+
+Describe the feature you'd like to see. Be specific about the API surface, behavior, and any configuration options.
+
+## Alternatives Considered
+
+Any alternative approaches or workarounds you've considered.
+
+## Use Case
+
+Describe the real-world scenario where this feature would be useful.
+
+## Additional Context
+
+Any mockups, references to other tools, or related issues.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,30 @@
+## Description
+
+Brief description of what this PR does.
+
+## Type of Change
+
+- [ ] 🐛 Bug fix
+- [ ] ✨ New feature
+- [ ] 📖 Documentation update
+- [ ] ♻️ Refactoring
+- [ ] 🧪 Test update
+- [ ] 🔧 Maintenance / chore
+
+## Changes Made
+
+- Change 1
+- Change 2
+
+## How to Test
+
+1. Step 1
+2. Step 2
+3. Verify that...
+
+## Checklist
+
+- [ ] My code follows the project's code style
+- [ ] I have tested my changes locally
+- [ ] I have updated documentation (if applicable)
+- [ ] My changes don't introduce new warnings

.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install ruff
+        run: pip install ruff
+      - name: Run linter
+        run: ruff check .
+
+  typecheck:
+    name: Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install dependencies
+        run: |
+          pip install -r requirements.txt
+          pip install mypy
+      - name: Run type checker
+        run: mypy agentline/ --ignore-missing-imports
+
+  docker-build:
+    name: Docker Build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build Docker image
+        run: docker build -t agentline .

.gitignore

@@ -0,0 +1,38 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.mypy_cache/
+.pytest_cache/
+.coverage
+htmlcov/
+.ruff_cache/
+
+# Virtual environments
+.env
+.venv/
+venv/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Docker
+pgdata/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log

CODE_OF_CONDUCT.md

@@ -0,0 +1,54 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior:
+
+* The use of sexualized language or imagery, and sexual attention or advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+**support@agentline.cloud**.
+
+All complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/),
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html).