# Aural

> Open-source AI interview platform for voice, chat, and video interviews.

Aural is an AI-powered interview platform that conducts structured, adaptive interviews at scale. Design an interview in plain language, share a link, and Aural's AI conducts the conversation — asking questions, probing with follow-ups, and generating detailed analysis when the session ends.

## Key Facts

- [Aural Website](https://aural-ai.com): Official website for the Aural AI interview platform
- [GitHub Repository](https://github.com/1146345502/aural-oss): Open-source codebase (MIT license)
- License: MIT (fully open source)
- Tech Stack: Next.js 14, TypeScript, Supabase (PostgreSQL), tRPC
- Company: AuraTerra Nexus Global Limited (Hong Kong)

## Core Capabilities

- **Voice, Chat & Video Interviews**: AI-driven interviews across all communication channels with real-time adaptation
- **AI Interview Generation**: Describe goals in plain language and get a complete interview with questions and scoring criteria
- **Live Coding & Whiteboard**: Monaco editor and Excalidraw for technical assessments
- **Automated Reports**: Per-question scores, highlights, and improvement areas generated by AI
- **Anti-Cheating**: Tab monitoring, paste blocking, multi-screen detection, integrity logs
- **Team Management**: Organizations, projects, and role-based access control
- **Multilingual**: English and Chinese with pluggable locale system
- **Pluggable LLMs**: OpenAI, Moonshot Kimi, MiniMax, or any OpenAI-compatible API

## Deployment Options

- [Cloud Hosted](https://aural-ai.com): Managed SaaS — sign up and start immediately
- [Self-Hosted](https://github.com/1146345502/aural-oss#self-hosted): Clone from GitHub, configure Supabase + LLM keys, and run on your own infrastructure

## Use Cases

- Technical hiring (coding and system design interviews)
- User research (in-depth research interviews with AI follow-ups)
- Behavioral interviews (voice-based conversations at scale)
- Interview practice (candidates practice with AI feedback)
- Customer discovery and expert interviews
- Academic research interviews

## Pricing

- Free: $0/month — 3 templates, 100 AI tokens, 1 hr session time
- Basic: $24/month — 10 templates, 500 AI tokens, 10 hrs session time
- Pro: $49/month — Unlimited templates, 2,000 AI tokens, 30 hrs session time
- Business: $99/month — Unlimited templates, 10,000 AI tokens, 100 hrs session time

## Documentation

- [Documentation](https://aural-ai.com/docs): Guides and tutorials for interview creators and interviewees
- [Blog](https://aural-ai.com/blog): AI interview tips, product updates, and industry trends
- [Self-Host Guide](https://github.com/1146345502/aural-oss#self-hosted): Deploy Aural on your own infrastructure
- [Contributing Guide](https://github.com/1146345502/aural-oss/blob/main/CONTRIBUTING.md): How to contribute to the open-source project

## Developer API

Aural provides a REST API for programmatic access to interviews, questions, sessions, and candidates.

- [API Reference](https://aural-ai.com/docs/developer-api/api-reference): Full REST API documentation
- [OpenAPI Spec](https://aural-ai.com/api/v1/openapi.json): Machine-readable API specification
- [Full API Reference](https://aural-ai.com/llms-full.txt): Complete API reference for LLMs
- Base URL: https://aural-ai.com/api/v1
- Auth: Authorization: Bearer dlv_xxx (create API keys in Settings > API Keys)

### Quick Start (5 steps)

1. Create interview: POST /api/v1/interviews { "title": "..." }
2. Add questions: POST /api/v1/interviews/{id}/questions [{ "text": "..." }]
3. Publish: POST /api/v1/interviews/{id}/publish
4. Share the returned URL with candidates
5. Get results: GET /api/v1/sessions/{id}

### Endpoints

- POST /api/v1/interviews — Create interview
- GET /api/v1/interviews — List interviews
- GET /api/v1/interviews/{id} — Get interview with questions
- PATCH /api/v1/interviews/{id} — Update interview
- DELETE /api/v1/interviews/{id} — Archive interview
- POST /api/v1/interviews/{id}/publish — Publish interview
- POST /api/v1/interviews/{id}/questions — Add questions
- GET /api/v1/interviews/{id}/sessions — List sessions
- GET /api/v1/sessions/{id} — Get session with transcript
- POST /api/v1/interviews/{id}/candidates — Create candidates
- GET /api/v1/usage — Check plan usage

### Usage Limits

API usage counts against your organization plan. Check limits via GET /api/v1/usage.

## Contact

- Support: support@aural-ai.com
- Sales: sales@aural-ai.com
- Security: security@aural-ai.com