Vector stores
The four vector store backends Aimogen Pro supports, how to configure each, and which to choose.
A vector store holds your embeddings and answers similarity queries. Aimogen Pro supports four.
Settings › Embeddings › Default Embeddings API To Use
Each option is only selectable once its credentials are configured — the settings screen disables the rest and says why.
Comparison#
| OpenAI Vector Stores | Pinecone | Qdrant | Chroma | |
|---|---|---|---|---|
| Added in | 2.8.3 | long-standing | long-standing | 2.8.3 |
| Hosting | OpenAI | Managed cloud | Managed or self-hosted | Managed or self-hosted |
| Setup effort | Lowest | Low | Medium | Medium |
| Requires an OpenAI key | yes | no | no | no |
| Self-hostable | no | no | yes | yes |
| Chunking | Handled by OpenAI | You supply vectors | You supply vectors | You supply vectors |
OpenAI Vector Stores#
The simplest option if you already use OpenAI. Files are uploaded and OpenAI handles chunking, embedding and retrieval.
| Setting | What it does |
|---|---|
OpenAI Vector Stores | Select up to 2 stores to search |
Create New Store | Creates one from the settings screen |
OpenAI Vector Store Results Limit | Maximum chunks returned per query. Default 3, range 1–50 |
OpenAI Vector Store Minimum Score (%) | Minimum relevance score. 0 disables filtering. Recommended 20 |
The minimum score is worth setting. Without it, a query with no good match still returns the least-bad chunks, and the model treats them as relevant. A threshold makes "I do not have that information" possible.
If no store is configured, the plugin creates one named "Aiomatic Vector Store" on first use and records its ID.
Pinecone#
| Setting | What it does |
|---|---|
Pinecone.io API Key | On Settings › API Keys |
Pinecone Index | The index host, for example mytestingindex-28cc276.svc.us-east1-gcp.pinecone.io |
Pinecone Namespace | Optional default namespace |
Number Of Results To Query | Chunks returned per query. Default 1 |
Number Of Results To Query defaults to 1, which is usually too few. Three to five gives the model enough
context without flooding the prompt.
Qdrant#
| Setting | What it does |
|---|---|
Qdrant API Key | On Settings › API Keys. From the Data Access Control tab of your Qdrant dashboard |
Qdrant Index URL | For example 29331ee6-....europe-west3-0.gcp.cloud.qdrant.io:6333 |
Qdrant Collection Name | The collection |
Same requirement: dimension 1536, metric cosine.
Qdrant can be self-hosted, which matters if your embedded content must not leave your infrastructure.
Chroma#
| Setting | What it does |
|---|---|
Chroma API Key | On Settings › API Keys |
Chroma Index URL | For example https://api.trychroma.com |
Chroma Tenant | Your tenant |
Chroma Database | The database |
Chroma Collection Name | The collection |
Same dimension and metric requirements. Also self-hostable.
Choosing#
| Situation | Choose |
|---|---|
| Already using OpenAI, want the least setup | OpenAI Vector Stores |
| Want a managed service with good tooling | Pinecone |
| Data must stay on your infrastructure | Qdrant or Chroma, self-hosted |
| Want to avoid an OpenAI dependency | Pinecone, Qdrant or Chroma |
| Evaluating | OpenAI Vector Stores, then migrate if needed |
Migrating between stores#
There is no migration tool. Changing store means re-indexing everything from source. That is one reason to
keep your source content in a form you can re-index — the aiomatic_embeddings posts remain in WordPress,
so re-indexing is feasible.
Cost#
OpenAI Vector Stores charge for storage per day plus retrieval.
Pinecone charges by index size and query volume, with a free tier.
Qdrant and Chroma charge for the managed service, or cost you a server if self-hosted.
For a typical WordPress site — a few thousand documents — all four are inexpensive.
Common problems#
Dimension mismatch errors. The index dimension does not match the embedding model. Recreate the index at the right dimension and re-index.
No results returned. The namespace does not match, the index is empty, or the score threshold is too high.
Connection errors. Wrong URL or key. Check the exact host format shown in the settings placeholders.
The store option is greyed out. Its credentials are not configured.
Related#
Still stuck? Open a support ticket and include the diagnostics from Aimogen Pro › System & Logs › System Info.