Skip to main content
This walks you from a clone to a grounded answer. For the full prerequisite matrix and production hardening, see Installation.
AskMyDocs is a Laravel 13 application. You need PHP 8.3+, Composer, Node 20+, and a PostgreSQL 15+ database with the pgvector extension. The Quickstart uses OpenAI for chat + embeddings; any supported provider works (see AI providers).
1

Clone and install

2

Configure the environment

Copy the example env and set your database + one AI provider key.
Then edit .env:
Embedding dimensions are part of the contract. The stock schema is sized for a 1536-dim model (openai/text-embedding-3-small). Switching to a different-dimension model means migrating the vector(N) columns, flushing the cache, and re-indexing — see Installation.
3

Migrate the database

pgvector must be installed in PostgreSQL first (CREATE EXTENSION vector;). Then run the migrations:
4

Ingest some documents

Point the folder ingester at a directory of markdown and assign a project key. Ingestion is idempotent — re-running on identical bytes is a no-op.
The same execution path is available over HTTP (POST /api/kb/ingest, Sanctum-protected, batch ≤ 100) — see Architecture overview.
5

Ask a grounded question

Use the stateless JSON API:
The response carries the answer, the citations that grounded it, and a meta block (provider, model, latency, retrieved-chunk count). Or open the React chat UI at /app/chat for the streaming experience with inline citations and suggested follow-ups.

​
What just happened

  1. Your markdown was chunked (section-aware), embedded, and upserted into PostgreSQL on the idempotency tuple (project_key, source_path, version_hash).
  2. Your question was embedded and run through hybrid retrieval — vector + full-text — then fused by the reranker.
  3. The grounded context was composed into a prompt and sent to your provider via AiManager, and the answer came back with citations to the exact chunks.

​
Next steps

Core concepts

Understand the canonical layer and the knowledge graph.

Connectors

Pull from Google Drive, Notion, Confluence, Jira and more.

Admin panel

Dashboards, RBAC, the KB explorer, logs, and maintenance.