← Back to Assistant

📖 Servantica AI — User Guide

Everything you need to know about using the Servantica AI Assistant — from getting started to mastering every capability.

🤖 Open Assistant 📡 API Docs

🚀 How to Use

1
Login Enter your username & password (Basic Auth) or paste a JWT token (Auth0 / Keycloak) and click Login.
2
Type or Speak Type in the text field and press Enter, or tap the 🎤 mic button to record your voice. You can also say "Hey Servantica" for hands-free activation.
3
Get Results The assistant processes your request, executes any actions (SMS, call, image, etc.), and responds with text & voice automatically.

⚡ AI Capabilities

🧠
AI Chat (GPT-4o)

Ask anything — coding, math, reasoning, translations, jokes, general knowledge. Multi-turn conversations with memory.

🎤
Voice Input (Whisper)

Speak naturally — your voice is transcribed using OpenAI Whisper and processed as text. Supports WAV, MP3, M4A, WEBM.

🔊
Voice Output (TTS)

Every response is spoken back to you. Choose from 6 voices: Alloy, Echo, Fable, Onyx, Nova, Shimmer.

📱
SMS — Send & Schedule

Send instant SMS or schedule messages for a specific date & time. Powered by Twilio via Notification Service.

"Send SMS to +917259510747 with message Hello!"
📞
Voice Calls

Make and schedule voice calls with a custom message. Powered by Twilio via Call Management Service.

"Call +917259510747 and say Your order is ready"
📧
Email — Send & Schedule

Send emails instantly or schedule them. Specify recipients, subject, and message body.

"Send email to user@example.com with subject Welcome"
🎨
Image Generation (DALL·E)

Generate images from text prompts using DALL·E. Images are returned as downloadable PNGs.

"Generate an image of a sunset over mountains"
🌤️
Weather

Get live weather forecasts for any city — temperature, conditions, humidity, wind.

"What's the weather in Bangalore?"
📰
News

Fetch top headlines and latest news on any topic or category.

"Top tech news today"
🔍
Web Search

Search the web for any topic — get summarized answers with source links.

"Search for latest iPhone release date"
📝
Voice Notes

Save, list, and delete notes using your voice. Notes appear in the side panel.

"Save a note: Buy groceries tomorrow"
Reminders

Set reminders for specific times. Say when you need to be reminded and what for.

"Remind me to call John at 3 PM"
📅
Date & Time

Ask about today's date, day of the week, time in any timezone, or date math.

"What day is tomorrow?" · "What's the time in Tokyo?"
🗣️
Wake Word — "Hey Servantica"

Enable the toggle and say "Hey Servantica" to start recording hands-free. Recognizes 24+ pronunciation variants with fuzzy matching. Mic is smart-muted during TTS playback to prevent echo on mobile.

⌨️ Keyboard Shortcuts

SpaceToggle voice recording
EnterSend text message
EscCancel recording / processing

💡 Tips & Tricks

🏢 About Servantica

🌐
Servantica Platform

A full-stack AI ecosystem — web app, voice assistant, notification service, call management, and more. Visit servantica.in

👨‍💻
Built by Anand Yadawad

Lead Developer & Owner · annadaneshwaryadawad1998@gmail.com · +91 7259510747

🛡️
Security

Triple-layer authentication: Auth0 JWT + Keycloak JWT + HTTP Basic Auth. All API calls are authenticated and secured.

☁️
Deployment

Deployed on Azure Web Apps with CI/CD via GitHub Actions. Spring Boot 3.5.8 + Java 21 + Spring AI 1.1.0.