# typesense

Sets up Typesense search backend, collection schemas, and typo tolerance. Useful for building product search or migrating from Algolia.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 139 installs · ★ 61 repo stars
- Author: akillness
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/typesense/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/typesense

## What it does

This skill guides the agent through running Typesense and integrating low-latency search into your application. It routes between running a single C++ binary directly, launching the official container, or connecting to Typesense Cloud. It includes a bundled `scripts/install.sh` file to start Docker and set up the Python client simultaneously.

The workflow covers typed collection design, JSONL document batching, faceting, and geo-distance queries. Search parameters and ranking criteria are applied at query time rather than index creation, keeping memory footprints lower than Algolia.

A functioning server needs an explicit master credential passed via `--api-key`. Pure embedding workloads with high-scale vector indexing belong in dedicated vector databases rather than this hybrid search pipeline.

## Requirements
- Works with: Docker

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill typesense -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/typesense/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/typesense/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill typesense -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/typesense/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill typesense -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/typesense/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akillness/jeo-skills .agent-skills/typesense/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/typesense/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill typesense -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/typesense
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/typesense/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill typesense -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/typesense/SKILL.md

## When to use it
- Spin up a local Typesense instance using Docker or direct binaries
- Define typed collection schemas with facet and filter capabilities
- Execute typo-tolerant queries with sorting, grouping, and synonyms
- Migrate search operations away from Algolia or Elasticsearch
- Assemble multi-search endpoints and high-availability Raft setups

## Example prompts
- Start a local Typesense Docker container and initialize a products schema
- Configure typo tolerance and country facets using the official Python client
- Design a multi-search query across collections with geo-distance ranking

## Similar
- [knative-istio-typesense-gpu-cursorrules-prompt-fil](https://affpapa.org/en/nevibecode/rules/knative-istio-typesense-gpu-cursorrules-prompt-fil.md) — rule · ★ 41178 repo stars
- [elk-stack](https://affpapa.org/en/nevibecode/skills/elk-stack.md) — skill · 374 installs
- [elastic-package-cli](https://affpapa.org/en/nevibecode/skills/elastic-package-cli.md) — skill · 515 installs
- [grepai-storage-qdrant](https://affpapa.org/en/nevibecode/skills/grepai-storage-qdrant.md) — skill · 570 installs
- [searxng-search](https://affpapa.org/en/nevibecode/skills/searxng-search.md) — skill · 838 installs
- [elasticsearch-index-design](https://affpapa.org/en/nevibecode/skills/elasticsearch-index-design.md) — skill · 1600 installs

From the same set: [akillness/jeo-skills](https://affpapa.org/en/nevibecode/by/akillness/jeo-skills.md) — 99 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
