Getting Started

This guide walks you through creating your first AI-powered search.

1. Create an Account

Go to brain.aistack.run/login and sign up for an account.

2. Create a Project

After logging in, click New Project in the dashboard and give it a name. Each project has its own documents and API keys.

3. Generate an API Key

Navigate to your project's API Keys page and create a new key. Choose the appropriate permission level:

Copy the key — it starts with rag_ and is only shown once.

4. Upload Your First Document

curl -X POST https://brain.aistack.run/api/v1/documents \
  -H "Authorization: Bearer rag_your_api_key" \
  -F "file=@README.md" \
  -F "filename=docs/readme.md"

The document will be automatically chunked and indexed. You can check the indexing status in the dashboard under Jobs.

5. Search Your Documents

Vector search — returns relevant document chunks:

curl -X POST https://brain.aistack.run/api/v1/search \
  -H "Authorization: Bearer rag_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"query": "How do I get started?"}'

AI search — returns an AI-generated answer with sources:

curl -X POST https://brain.aistack.run/api/v1/ai-search \
  -H "Authorization: Bearer rag_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"query": "How do I get started?"}'

Next Steps

• API Reference — Complete endpoint documentation
• Concepts — Learn how RAG search works
• Guides — Common patterns and integration examples