NEWVectors or files. Pick a path.Start →
    Similar

    BYO Embeddings Vector Search

    Bring pre-computed embeddings from any provider (OpenAI, Cohere, Together, etc.) and upsert them directly into MVS for instant vector search. No feature extractors, no pipelines -- just embeddings in, results out.

    text
    image
    Single Tier

    "Find DevOps tutorials about container orchestration"

    Why This Matters

    Skip the managed pipeline entirely when you already have embeddings. MVS gives you production-grade vector search with filtering, hybrid queries, and multi-tenancy without lock-in to any embedding provider.

    from openai import OpenAI
    from mixpeek import Mixpeek
    openai = OpenAI(api_key="YOUR_OPENAI_KEY")
    client = Mixpeek(api_key="YOUR_API_KEY")
    NAMESPACE = "byo-docs"
    def embed(text):
    return openai.embeddings.create(model="text-embedding-3-small", input=text).data[0].embedding
    # 1. A standalone namespace for vectors you bring. text-embedding-3-small returns 1536 numbers.
    client.namespaces.create(
    namespace_id=NAMESPACE,
    mode="standalone",
    vector_configs=[{"name": "dense", "dimension": 1536, "metric": "cosine"}],
    )
    # 2. Upsert each document with its named vector and a payload
    documents = [
    {"id": "doc-1", "text": "How to deploy a Kubernetes cluster", "category": "devops"},
    {"id": "doc-2", "text": "Introduction to neural network architectures", "category": "ml"},
    {"id": "doc-3", "text": "Building REST APIs with FastAPI", "category": "backend"},
    ]
    client.namespaces.documents.upsert(
    namespace_id=NAMESPACE,
    documents=[
    {"document_id": d["id"], "vectors": {"dense": embed(d["text"])}, "payload": {"text": d["text"], "category": d["category"]}}
    for d in documents
    ],
    )
    # 3. Search with a query vector. feature_uri is the vector name you upserted under.
    results = client.search(
    namespace_id=NAMESPACE,
    queries=[{
    "feature_uri": "dense",
    "query": {"input_mode": "vector", "value": embed("how to set up container orchestration")},
    "top_k": 5,
    }],
    )
    for doc in results["documents"]:
    print(round(doc["score"], 3), doc.get("category"), doc.get("text"))

    Feature Extractors

    Retriever Stages

    feature search

    Search and filter documents by vector similarity using feature embeddings

    filter

    Related Recipes & Resources

    Explore these related resources to deepen your understanding and discover more powerful features

    Recipe

    Document Intelligence Search

    Extract and search through PDFs, presentations, and documents. Combines OCR, layout analysis, and semantic search for comprehensive document retrieval.

    Learn more
    Recipe

    Multimodal Hybrid Search Pipeline

    Combine vector search with keyword search (BM25) across text, images, and video for the most comprehensive multimodal retrieval system.

    Learn more
    Recipe

    Clinical Documentation Structuring

    Production-grade pipeline for ingesting clinical documents, scanned charts, EHR exports, wound photos, and therapy notes, and structuring them into coded fields aligned with MDS 3.0, PDPM, and CMS audit requirements. Combines OCR, clinical NER, taxonomy classification, and hybrid retrieval to turn unstructured bedside documentation into queryable, auditable data.

    Learn more
    Recipe

    Dense Search Over Your Own Embeddings, and What Hybrid Needs

    Upsert documents you embedded elsewhere into an MVS namespace and search them by raw vector through the features search endpoint. Hybrid BM25 plus dense is not part of a plain BYO upsert: the documents carry dense vectors only and no text index is created. If you want a lexical leg later, declare a TEXT payload index on the field when you create the namespace; this recipe shows that declaration and the dense search that works today.

    Learn more
    Recipe

    Multimodal Search with MVS

    Build multimodal search by embedding different content types (text, images, video frames) with your own models and searching across them in a single MVS namespace. Use CLIP or any multimodal embedding model for cross-modal retrieval.

    Learn more
    Recipe

    PDF Data Extraction Pipeline

    Extract structured data from PDFs including tables, forms, and text. Convert unstructured documents into structured, queryable data.

    Learn more