# Call2Me - Open Source Voice AI Platform

> Build intelligent voice agents that can make and receive phone calls.

## What is Call2Me?

Call2Me is a self-hosted Voice AI platform that enables developers to create intelligent voice agents capable of natural phone conversations. It's an open-source alternative to Retell AI and Vapi.

## Key Features

- **Voice Agents**: Create AI agents with custom personalities, voices, and behaviors
- **Multi-Provider Support**: OpenAI, Azure, Google, Deepgram, ElevenLabs integration
- **Custom LLM**: Connect your own language model via WebSocket
- **Knowledge Base**: RAG-powered agents with pgvector for semantic search
- **Telephony Ready**: SIP/RTP integration with Kamailio and FreeSWITCH
- **Self-Hosted**: Full control over your data and infrastructure
- **API First**: RESTful API with OpenAPI documentation

## Technology Stack

- **Backend**: Python 3.11+, FastAPI, Pydantic v2
- **Database**: PostgreSQL with pgvector extension
- **Cache**: Redis
- **AI Providers**: OpenAI (Whisper, GPT, TTS), Google Gemini, Deepgram, ElevenLabs
- **Telephony**: Kamailio (SIP), FreeSWITCH (Media)

## API Endpoints

### Agents
- POST /v1/agents - Create voice agent
- GET /v1/agents - List agents
- GET /v1/agents/{id} - Get agent details
- PATCH /v1/agents/{id} - Update agent
- DELETE /v1/agents/{id} - Delete agent

### Calls
- POST /v1/calls - Create outbound call
- GET /v1/calls - List calls
- GET /v1/calls/{id} - Get call details
- POST /v1/calls/{id}/end - End call

### Knowledge Base
- POST /v1/knowledge-bases - Create knowledge base
- GET /v1/knowledge-bases - List knowledge bases
- POST /v1/knowledge-bases/{id}/sources - Add sources

### Voices
- GET /v1/voices - List available voices

## Quick Start

```bash
git clone https://github.com/umutcetinkaya/call2me.git
cd call2me
docker-compose -f docker/docker-compose.dev.yml up -d
curl http://localhost:8000/health
```

## Links

- Website: https://call2me.app
- GitHub: https://github.com/umutcetinkaya/call2me
- Documentation: https://call2me.app/docs
- API Reference: https://call2me.app/docs

## License

MIT License

## Contact

- GitHub: @umutcetinkaya
- Website: https://call2me.app