Documentation

Get started with Voxa AI

Everything you need to know to learn, research and practise faster with Voxa.

Quick start

  1. 1

    Create an account

    Sign up with your name, email and a password — or use the demo account to explore with sample data.

  2. 2

    Open the dashboard

    The dashboard shows your recent chats and documents, weekly usage and shortcuts to every tool.

  3. 3

    Pick a tool

    Start a chat, upload a PDF, open the AI tutor or generate notes. Everything you create is saved to your workspace.

Feature guides

AI ChatAsk anything. Conversations keep context, support Markdown and code blocks, and are saved to History. Organise chats into folders.Voice AssistantSpeak your question and hear the answer read back. Uses your browser's speech recognition, so allow microphone access.AI TutorChoose a subject and learn step by step. The tutor explains, gives examples and checks your understanding.Doc AnalyzerUpload a PDF, DOCX or TXT file. Voxa extracts the text and answers questions grounded in your document.AI NotesPick a subject, enter a topic and get structured study notes you can save and revisit.PresentationsEnter a topic and get a slide deck outline with titles and bullet points, ready to present.Mock InterviewPractise interviews for a role and level. Answer each question and get feedback on clarity and content.My FilesAll uploaded documents and images in one place, with previews and downloads.

API

The backend is a FastAPI service. Authenticate with POST /api/auth/login and send the returned token as Authorization: Bearer <token>.

curl -X POST $API/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "••••••"}'

curl -X POST $API/api/chats/<chat_id>/messages \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"message": "Explain overfitting in one sentence."}'

FAQ

Which AI model does Voxa use?+

Voxa talks to models through an OpenAI-compatible API. The hosted version uses Google Gemini, with automatic fallback between models when one is busy.

Is my data private?+

Your chats, notes and documents are linked to your account and only returned to you when you're signed in. Passwords are stored as bcrypt hashes.

Why is the first request slow?+

The backend runs on a free hosting tier that sleeps when idle. The first request after a quiet period can take up to a minute while it wakes up.

What file types can I upload?+

PDF, DOCX and TXT for document analysis, and common image formats for the image tools.