Documentation
Everything you need to get started with Poros Alpha.
Getting Started
Poros Alpha is ready to use right in your browser. Just head to the Chat page and start asking questions.
What You Can Do
- Ask questions in plain English — the AI translates them to SQL
- Analyze files by describing what you need
- Switch between AI models using the dropdown in the chat header
- Watch the Thinking Panel to see tool calls in real-time
Available Models
| Model | Provider | Best For | Tier |
|---|---|---|---|
| Gemini 2.5 Flash | General purpose, fast responses | Free | |
| Llama 3.1 70B | Groq | Complex reasoning, analysis | Free |
| Mixtral 8x7B | Groq | Code generation, multilingual | Free |
Self-Hosting
Poros can be self-hosted with Docker:
# Clone the repo git clone https://github.com/your-org/PorosAlpha.git cd PorosAlpha # Set up environment cp .env.example .env # Edit .env with your API keys # Run with Docker docker compose up # Or run locally cd backend-api && python main.py # API on :8000 cd frontend && npm run dev # UI on :3000
FAQ
Is Poros really free?
Yes. The free tier uses models with generous free quotas from Google (Gemini) and Groq (Llama, Mixtral). You only need API keys, which are free to obtain.
What databases are supported?
Poros supports SQLite and PostgreSQL out of the box. MSSQL and MySQL support can be added via optional dependencies.
Is my data sent to third parties?
Your queries are sent to the selected LLM provider (Google or Groq) for processing. You can self-host with a local model to keep all data on-premise.
Can I add my own tools?
Yes. Create a new tool in poros_agent/tools/ and register it in the MCP server. The agent will automatically discover and use it.