{"id":44221964,"url":"https://github.com/health-informatics-uon/quick-vector-search","last_synced_at":"2026-02-10T04:04:48.746Z","repository":{"id":308372936,"uuid":"1032535842","full_name":"Health-Informatics-UoN/quick-vector-search","owner":"Health-Informatics-UoN","description":null,"archived":false,"fork":false,"pushed_at":"2025-08-05T14:38:50.000Z","size":67,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-05T16:26:05.450Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Health-Informatics-UoN.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-05T12:58:38.000Z","updated_at":"2025-08-05T14:38:53.000Z","dependencies_parsed_at":"2025-08-05T16:43:36.261Z","dependency_job_id":null,"html_url":"https://github.com/Health-Informatics-UoN/quick-vector-search","commit_stats":null,"previous_names":["health-informatics-uon/quick-vector-search"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Health-Informatics-UoN/quick-vector-search","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Health-Informatics-UoN%2Fquick-vector-search","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Health-Informatics-UoN%2Fquick-vector-search/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Health-Informatics-UoN%2Fquick-vector-search/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Health-Informatics-UoN%2Fquick-vector-search/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Health-Informatics-UoN","download_url":"https://codeload.github.com/Health-Informatics-UoN/quick-vector-search/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Health-Informatics-UoN%2Fquick-vector-search/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29290477,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-10T03:42:42.660Z","status":"ssl_error","status_checked_at":"2026-02-10T03:42:41.897Z","response_time":65,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-10T04:03:58.314Z","updated_at":"2026-02-10T04:04:48.741Z","avatar_url":"https://github.com/Health-Informatics-UoN.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Quick Vector Search\n\nA user-friendly interface for performing vector search on OMOP (Observational Medical Outcomes Partnership) databases with embedded Common Data Model (CDM) data.\n\n## Overview\n\nThis tool provides a streamlined way to search through medical data using semantic vector similarity. It leverages embeddings stored alongside your OMOP CDM data to enable natural language queries and find semantically similar medical concepts, procedures, and observations.\n\n## Features\n\n- **Interactive GUI**: Built with Marimo for a responsive interface\n- **Vector Search**: Semantic search capabilities using sentence transformers\n- **OMOP Integration**: Direct integration with OMOP CDM databases\n- **Natural Language Queries**: Search using plain English descriptions\n\n## Prerequisites\n\n- Python 3.12 or higher\n- PostgreSQL database with pgvector extension\n- OMOP CDM database with precomputed embeddings\n- uv package manager\n\n## Installation\n\n1. **Clone the repository:**\n   ```bash\n   git clone https://github.com/health-Informatics-UoN/quick-vector-search\n   cd quick-vector-search\n   ```\n\n2. **Install dependencies:**\n   ```bash\n   uv sync\n   ```\n\n3. **Install the package in development mode:**\n   ```bash\n   uv pip install -e .\n   ```\n\n## Configuration\n\nThere are defaults for database connection details.\n\n```env\nDB_HOST=\"localhost\"\nDB_PORT=5432\nDB_USER=\"postgres\"\nDB_PASSWORD=\"password\"\nDB_NAME=\"omop\"\nDB_SCHEMA=\"cdm\"\nDB_VECTABLE=\"embeddings\"\nEMBEDDINGS_MODEL=\"baai/bge-small-en-v1.5\"\n```\n\nIf you need to change any of these to match your database, then create a `.env` file in the project root with your database connection details.\n\n## Usage\n\n### Starting the UI\n\nLaunch the vector search interface:\n\n```bash\nuv run vsui\n```\n\nThis will start the Marimo interface where you can enter natural language search queries.\n\n### Project Structure\n\n```\nquick-vector-search/\n│   ├── db/              # Database connection and queries\n│   ├── settings/        # Configuration management\n│   ├── vector_search.py  # Main UI application\n│   └── run_vs_ui.py     # Entry point script\n├── pyproject.toml           # Project configuration\n└── README.md               # This file\n```\n\n## Development\n\n### Adding New Features\n\n1. **Database operations**: Add new queries in `quick_vector_search/db/`\n2. **UI components**: Modify `quick_vector_search/vector_search.py`\n3. **Configuration**: Update settings in `quick_vector_search/settings/`\n\n### Code Quality\n\nThe project includes Ruff for linting and formatting:\n\n```bash\nuv run ruff check\nuv run ruff format\n```\n\n## Requirements\n\n- Your OMOP database should have embeddings precomputed and stored\n- PostgreSQL must have the pgvector extension installed\n- Sufficient memory for loading sentence transformer models\n\n## Troubleshooting\n\n### Common Issues\n\n1. **Database Connection**: Ensure PostgreSQL is running and pgvector extension is installed\n2. **Memory Issues**: Sentence transformer models can be memory-intensive\n3. **Missing Embeddings**: Verify that your OMOP database includes embedded vectors\n\n### Getting Help\n\n- Check the Marimo documentation for UI-related issues\n- Verify your database schema matches OMOP CDM standards\n- Ensure pgvector extension is properly configured\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Run tests and linting\n5. Submit a pull request\n\n\n## Acknowledgments\n\n- Built on the OMOP Common Data Model\n- Uses the Marimo reactive notebook framework\n- Powered by Hugging Face sentence transformers\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhealth-informatics-uon%2Fquick-vector-search","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhealth-informatics-uon%2Fquick-vector-search","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhealth-informatics-uon%2Fquick-vector-search/lists"}