AI chat, your way
Stream conversations with OpenAI, Claude, Gemini, or Grok. Search, reopen, rename, and continue chat history.
One workspace. Your AI.
Bring your AI together. Keep control.
Chat with leading AI providers, ask questions about your own files, and keep your keys in your hands—all from one workspace you operate.
This is an interactive demo; AI providers aren’t connected.
Bring your own provider keys. Encrypted at rest.
✳ AI workspace
OpenAI ⌄
Message your AI assistant…
One workspace for your AI providers
OpenAI
Anthropic
Gemini
xAI
A workspace that works together
The tools around your AI, all in one place.
Go from a quick question to a grounded answer, revisit a past conversation, or bring your team into the picture.
Answers grounded in your files
Upload text, Markdown, CSV, and text-based PDF documents and use relevant passages as chat context.
Your keys stay yours
Bring your own provider API keys. Amiral encrypts saved keys at rest and shows only a masked hint.
Team-ready foundations
Create organizations, invite teammates, and manage admin, member, and viewer roles.
Built for the whole product
The important details are part of the workspace, too.
Amiral includes the operational foundations around AI chat—from account controls and guarded tools to deployment options you can own.
Admin user controls
Admins can review the user directory, see account roles and status, and suspend or reactivate access.
Bounded AI agent tools
OpenAI chat can use built-in tools for current UTC time and estimated token cost, with validated inputs and a bounded tool-call limit. It is not a general-purpose autonomous agent.
Log leak protection
A log guard redacts common credentials—including API keys, passwords, tokens, and secrets—from application log records.
Account security
JWT sign-in, bcrypt password hashing, verified email for new accounts, and admin account suspension help protect workspace access.
Usage visibility
Provider token usage and estimated costs are recorded for requests. Cost figures are estimates, not provider invoices or exact billing totals.
Credits and secure checkout
Optional pay-per-use credits, fixed top-up packages, Stripe Checkout, and signed webhook processing for paid credit grants.
Redis-powered safeguards
Redis supports response caching and rate limiting, including a default limit of 10 chat requests per user per minute.
Self-host or go desktop
Run the web stack with Docker Compose or package the React app as a Windows, macOS, or Linux desktop app with Tauri. Desktop still connects to your backend.
Bring your own key
Your providers. Your credentials. Your call.
Connect the models you already use instead of being locked into a single provider. Your key is encrypted before it’s stored, and the Vault shows only a masked hint.
- ✓Choose OpenAI, Anthropic Claude, Google Gemini, or xAI Grok.
- ✓Use your provider account and key for AI chat.
- ✓Switch providers in the workspace when you need to.
Connected providers
◈ Encrypted storage
Saved
Saved
Saved
Saved
Your provider credentials are encrypted at rest. Keep your encryption key safe when operating your own Amiral deployment.
AI Workspace
Ground with documents ✓
What did we decide about the product launch?
Based on your project notes
Your team plans a gradual launch, starting with a small group of early users. The notes recommend gathering feedback before opening access more widely.
product-notes.md Source
Your knowledge, in context
Give your conversations something real to work with.
Bring your own files into the conversation. Amiral retrieves relevant text and includes it as context, so you can ask questions about your own material.
- ✓Upload TXT, Markdown, CSV, and text-based PDF files.
- ✓Keep documents scoped to your account and see source names in answers.
- ✓Turn document grounding on or off for each conversation.
For your team
Make room for people, not permission chaos.
Create an organization, invite teammates by email, and manage access with clear roles. Team membership is separate from personal chats, documents, keys, and billing.
Explore organizationsProduct studio3 members
JDJordan DavisAdmin
MKMorgan KimMember
ALAlex LeeViewer
Clear usage. Flexible credits.
See your balance and manage credit top-ups in Billing. When enabled by the workspace operator, pay-per-use credits can be charged for chat usage.
What you get
A foundation to build on—not a hosted AI subscription.
Amiral is a self-hosted source-code starter kit. You run the application and connect the services and provider accounts you choose.
Application stack
FastAPI and Python backend, React frontend, Tailwind CSS, PostgreSQL with pgvector, Redis, and Docker Compose setup.
AI workspace features
Streaming chat for four providers, encrypted BYOK vault, searchable chat history, private document retrieval, and limited OpenAI tools.
SaaS foundations
Email-verified accounts, admin user controls, organization roles and invitations, usage tracking, optional credits, and Stripe checkout integration.
More ways to run it
A Tauri desktop shell for Windows, macOS, and Linux, plus configuration and setup instructions in the project README.
Your own deployment
Run the web app and API on infrastructure you choose. Amiral does not host or operate the product for you.
License included with purchase
A non-exclusive, non-transferable global license for unlimited commercial or personal projects, subject to the restrictions below.
Requirements & costs
The license is one part of running your product.
The $40 purchase is for the starter-kit license. You choose and pay for any infrastructure and third-party services needed for your deployment.
To run the web app
Docker Desktop or Docker Engine with Compose and OpenSSL for setup. You’ll also need a server or local machine to run the stack.
To register users
Configure SMTP host and sender details for email verification and organization invitations. Your email provider may charge separately.
To use AI & documents
Users provide their own AI provider API keys for chat. Document embeddings use OpenAI and can incur separate API usage charges.
Optional payments
Stripe credentials are only needed if you enable credit purchases. Stripe processes payments under its own pricing and terms.
Optional desktop builds
Node.js/npm, Rust, and platform-specific Tauri build prerequisites are required to develop or package desktop apps.
Costs vary by your setup
Hosting, domain, provider API usage, embeddings, email delivery, and payment processing are not included in the $40 license price.
Quick start
From source code to your first chat.
Use the full setup guide for prerequisites and deployment details.
Prepare configuration
Generate local secrets and create your environment file.
./setup.sh
Configure services
Set your admin email, SMTP sender and credentials, frontend URL, and deployment settings in .env.
Build and migrate
Build the containers, start database services, then apply migrations before starting the app.
Verify and connect
Register and verify your email, sign in, then add a provider key in API Vault to chat.
docker compose build backend frontend
docker compose up -d db redis
docker compose run --rm backend alembic upgrade head
docker compose up -d backend frontend
One-time starter-kit license
Build your product with Amiral.
Purchase grants the commercial license below for the source code. This is not access to a hosted Amiral service; hosting, AI provider usage, email, and other third-party services are your responsibility.
$40USD · one time
Get lifetime access for $40 USD
Checkout opens on Gumroad. Review the product listing and license terms before purchasing.
Read the license terms
Security notes
Security features are included. Deployment is still yours to secure.
Amiral provides security-related controls in its codebase; review the implementation and configure your own environment before production use.
◈ Credentials & accounts
Provider keys in the Vault are encrypted at rest with Fernet. Account passwords use bcrypt, and API authentication uses expiring JWTs.
⌁ Log redaction module
A log guard module can redact common credentials from log records. Review and install it in application startup before relying on log redaction; verify your logging setup.
◷ Abuse & request controls
Redis-backed rate limits protect selected endpoints. Configure HTTPS, restrict database and Redis access, and monitor your own deployment.
⌑ Operator responsibilities
Generate and protect strong secrets, keep them out of source control, secure SMTP and Stripe credentials, apply migrations carefully, and maintain backups.
License
Commercial license terms
These terms are reproduced from the repository’s LICENSE file. Read them before purchasing.
AMIRAL - COMMERCIAL LICENSE
Grant of License: By purchasing this boilerplate, you are granted a non-exclusive, non-transferable, global license to use the source code to create unlimited commercial or personal projects, SaaS applications, and software products.
Restrictions: 1. You MAY NOT redistribute, resell, lease, license, or sub-license the source code (or a modified version of it) as a standalone boilerplate, template, or starter kit. 2. You MAY NOT make the source code publicly available in any repository.
Disclaimer: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND. THE AUTHOR SHALL NOT BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING FROM THE USE OF THIS SOFTWARE.
A workspace that’s yours to run
Make your AI setup feel like one.
Bring your providers, files, and workflow together with an open-source starter you can run and customize.
Open Amiral