Files · AI Interview Coordinator for Boutique Recruiting Firms

# AI Interview Coordinator for Boutique Recruiting Firms
 
> Automatically schedule interviews across candidates and panelists without the back-and-forth.
 
A voice-first AI agent that schedules interviews for recruiting firms using LiveKit for voice interaction, Google Calendar for scheduling, agent-mesh for orchestration, **agent-memory for persistent candidate/panelist context**, and OpenAI for LLM reasoning.
 
## Architecture
 
```
Caller → LiveKit Room → InterviewVoiceAgent → InterviewCoordinator → (AgentRouter → dispatchToAgent → MCP agents / CalendarAdapter / MemoryService / OpenAI LLM)
```
 
## Getting Started
 
```bash
pnpm install
cp .env.example .env
# Fill in your API keys
pnpm dev
```
 
## API Reference
 
| Method | Path | Description |
|--------|------|-------------|
| POST | /api/interview | Schedule a new interview |
| GET | /api/interview/:id | Get interview details |
| PATCH | /api/interview/:id | Reschedule an interview |
| DELETE | /api/interview/:id | Cancel an interview |
| POST | /api/availability | Check panelist availability |
| POST | /api/webhook/livekit | LiveKit voice agent webhook |
| POST | /api/mcp/schedule | MCP dispatch for scheduling |
| POST | /api/mcp/availability | MCP dispatch for availability |
 
## Environment Variables
 
| Variable | Required | Description |
|----------|----------|-------------|
| OPENAI_API_KEY | Yes | OpenAI API key for LLM + embeddings |
| LIVEKIT_API_KEY | Yes | LiveKit server API key |
| LIVEKIT_API_SECRET | Yes | LiveKit server API secret |
| LIVEKIT_URL | Yes | LiveKit WebSocket URL |
| GOOGLE_CLIENT_EMAIL | Yes | Google service account email |
| GOOGLE_PRIVATE_KEY | Yes | Google service account private key |
| GOOGLE_CALENDAR_ID | No | Calendar ID (defaults to primary) |
| LANGFUSE_PUBLIC_KEY | No | Langfuse public key |
| LANGFUSE_SECRET_KEY | No | Langfuse secret key |
| LANGFUSE_BASE_URL | No | Langfuse host URL |
 
## Testing
 
```bash
pnpm typecheck
pnpm lint
pnpm test
```
 
## Project Layout
 
```
app/                  Next.js App Router pages + API routes
  api/                REST + MCP + webhook handlers
src/                  Application code
  lib/                Config, types, errors, utilities
  services/           Business logic + agent orchestration
tests/                Vitest suite (mirrors src/)
packages/             API references for every dependency
DEV_PLAN.md           Build plan for this recipe
```
 
## License
 
MIT — see [LICENSE](./LICENSE).