intersystems-community/fhir-ai-hackathon-kit/iris-vector-search
Claude Code and agent skill by intersystems-community/fhir-ai-hackathon-kit
- community
Checking that the SKILL.md file is still in the repository.
Store text embeddings in an InterSystems IRIS VECTOR column and run semantic similarity search with SQL (TO_VECTOR, VECTOR_COSINE). Covers table DDL, chunking PDFs with pymupdf and langchain-text-splitters, embedding with OpenAI text-embedding-3-small, inserting, and a reusable search function for RAG or agent tools. Use for any vector / semantic search / RAG task against IRIS.
Install
npx vskill@latest install intersystems-community/fhir-ai-hackathon-kit/iris-vector-searchSKILL.md
Vector search in IRIS
Source tutorial: Tutorials/4-vector-search/4.1-vector-search.ipynb, skip-setup Tutorials/setup-scripts/setup_vector_store.py (builds Diabetes.VectorStore from Tutorials/data/papers/*.pdf).
Deps: intersystems-irispython openai python-dotenv pymupdf langchain-text-splitters. OPENAI_API_KEY in repo-root .env, loaded with load_dotenv(). Connection args: see iris-sql-python skill.
Table
Dimension must equal the embedding model's output: text-embedding-3-small = 1536.
Chunk documents
Keep chunk length under the Text column size.
Embed and insert
Embeddings go in as a string (str(list_of_floats)) wrapped in TO_VECTOR(?).
Embedding calls cost money; batch them and log progress. The tutorial stores Source as ../data/papers/<file>.pdf.
Search
VECTOR_COSINE= cosine similarity (higher is closer, sortDESC).VECTOR_DOT_PRODUCTalso available; for normalised OpenAI embeddings they rank the same.- Query and stored vectors must come from the same model.
- Combine with normal SQL filters:
WHERE Source LIKE '%Retinopathy%' ORDER BY VECTOR_COSINE(...) DESC. - Return the score for thresholding:
SELECT TOP 3 Text, VECTOR_COSINE(Embedding, TO_VECTOR(?, DOUBLE)) AS Score ...(bind the vector twice if also ordering by it, orORDER BY Score DESC).
This function is ready to hand to an agent as a tool; see the iris-ai-agents skill.
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/iris-vector-search/SKILL.md
Popularity
- Repository stars
- 11
- Repository forks
- 9
- 7-day trend score
- 0
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/intersystems-community/fhir-ai-hackathon-kit/iris-vector-search)