> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moss.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Quickstart
> Install, authenticate, create an index, and query it (JS/Python tabs)
Follow one path to a visible result. Choose your language tab.
## Prerequisites:
* Node.js 18+ or Python 3.10+
* Valid Moss project credentials (`MOSS_PROJECT_ID`, `MOSS_PROJECT_KEY`)
* JS: `@moss-dev/moss`; Python: `moss`
```bash JavaScript theme={null}
npm install @moss-dev/moss
```
```bash Python theme={null}
pip install moss
```
From the Moss portal, copy your project credentials. Set them as env vars:
```bash theme={null}
export MOSS_PROJECT_ID="your_project_id"
export MOSS_PROJECT_KEY="your_project_key"
```
Save and run `npx tsx quickstart.ts` or `python quickstart.py`):
```ts JavaScript theme={null}
import { MossClient, DocumentInfo } from '@moss-dev/moss'
const client = new MossClient(process.env.MOSS_PROJECT_ID!, process.env.MOSS_PROJECT_KEY!)
const documents: DocumentInfo[] = [
{ id: 'doc1', text: 'How do I track my order? You can track your order by logging into your account.', metadata: { category: 'shipping' } },
{ id: 'doc2', text: 'What is your return policy? We offer a 30-day return policy for most items.', metadata: { category: 'returns' } },
{ id: 'doc3', text: 'How can I change my shipping address? Contact our customer service team.', metadata: { category: 'support' } },
]
const indexName = 'faqs'
await client.createIndex(indexName, documents, { modelId: 'moss-minilm' }) // default; use 'moss-mediumlm' for higher accuracy
await client.loadIndex(indexName)
const results = await client.query(indexName, 'How do I return a damaged product?', { topK: 3 })
console.log(results.docs[0])
```
```python Python theme={null}
import os
import asyncio
from moss import MossClient, DocumentInfo, QueryOptions
client = MossClient(os.getenv("MOSS_PROJECT_ID"), os.getenv("MOSS_PROJECT_KEY"))
index_name = "faqs"
documents = [
DocumentInfo(id="doc1", text="How do I track my order? You can track your order by logging into your account.", metadata={"category": "shipping"}),
DocumentInfo(id="doc2", text="What is your return policy? We offer a 30-day return policy for most items.", metadata={"category": "returns"}),
DocumentInfo(id="doc3", text="How can I change my shipping address? Contact our customer service team.", metadata={"category": "support"}),
]
async def main():
await client.create_index(index_name, documents, "moss-minilm") # default; use "moss-mediumlm" for higher accuracy
await client.load_index(index_name)
results = await client.query(index_name, "How do I return a damaged product?", QueryOptions(top_k=3, alpha=0.6))
print(f" ID: {results.docs[0].id}")
print(f" Text: {results.docs[0].text}")
print(f" Score: {results.docs[0].score}")
asyncio.run(main())
```
## Example output
```json theme={null}
{
"id": "doc2",
"score": 0.88,
"text": "What is your return policy? We offer a 30-day return policy for most items."
}
```
Need keyword-heavy results? Set `alpha` to `0.0` for pure keyword, `1.0` for pure semantic, or a blend in between (see [Hybrid Search](/docs/integrate/hybrid-search) for details).
## Next steps
You just created a cloud index and queried it. Moss does much more:
Indexes, embeddings, retrieval, sessions, and sync in one place.
Local-first, real-time indexing during a live interaction.
Blend semantic and keyword scoring with `alpha`.
Narrow results with `$eq`, `$in`, `$near`, and more.
Bring your own vectors instead of the built-in model.
Query several indexes at once for a global top-K.
Hydrate on-device indexes and keep them fresh.
Full per-language API: Python, JavaScript, Swift, Elixir, Browser, C.