{"id":48511804,"url":"https://github.com/mit-ll/linkq","last_synced_at":"2026-04-07T17:33:27.007Z","repository":{"id":243728046,"uuid":"811868317","full_name":"mit-ll/linkq","owner":"mit-ll","description":null,"archived":false,"fork":false,"pushed_at":"2026-03-30T16:03:20.000Z","size":4488,"stargazers_count":29,"open_issues_count":0,"forks_count":3,"subscribers_count":9,"default_branch":"main","last_synced_at":"2026-03-30T18:05:29.214Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/mit-ll.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-06-07T13:18:43.000Z","updated_at":"2026-03-30T15:46:43.000Z","dependencies_parsed_at":"2024-06-10T22:42:20.869Z","dependency_job_id":"32886aca-ac8b-4e53-986e-c86eeb3849fe","html_url":"https://github.com/mit-ll/linkq","commit_stats":null,"previous_names":["mit-ll/linkq"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/mit-ll/linkq","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mit-ll%2Flinkq","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mit-ll%2Flinkq/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mit-ll%2Flinkq/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mit-ll%2Flinkq/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mit-ll","download_url":"https://codeload.github.com/mit-ll/linkq/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mit-ll%2Flinkq/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31522418,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"ssl_error","status_checked_at":"2026-04-07T16:28:06.951Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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-04-07T17:33:26.872Z","updated_at":"2026-04-07T17:33:26.981Z","avatar_url":"https://github.com/mit-ll.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LinkQ: An LLM-Assisted Visual Interface for Knowledge Graph Question-Answering\n\nIEEE VIS 2024 Paper: https://ieeexplore.ieee.org/document/10771088\n\nDemo Site: https://mit-ll.github.io/linkq\n\n[![Screenshot](/public/screenshot.png)](https://mit-ll.github.io/linkq)\n\n\n\nCreated with React + TypeScript + Vite\n\nThis implementation is set up out of the box to query Wikidata with SPARQL. You can use an OpenAI LLM, or any LLM hosted using an OpenAI-compatible API server (for example Llama3 hosted by [vLLM](https://github.com/vllm-project/vllm))\n\n## Setup\n\n1. Clone this repo\n2. Install the necessary node packages\n```\nnpm i\n```\n3. Get an API key from OpenAI https://openai.com/blog/openai-api\n4. Duplicate `.env` and rename the new file to `.env.local`\n5. Paste your API key into `.env.local`. DO NOT paste your API key into `.env`. It will be committed to the repo. `.env.local` will NOT be committed. You can read more about environment variables here https://vitejs.dev/guide/env-and-mode\n6. Run the development server\n```\nnpm run dev\n```\n7. Open the webapp in your browser at http://localhost:5173/\n\n\n## Change KG Data Source\n`src/utils/knowledgeBase` contains most of the code that you would have to change to switch to a different KG data source. There are also some types in `src/types/idTable.ts` and `src/types/sparql.ts` that would need to be changed if you want to use a different datasource or query language.\n\n## Citation\n```\n@INPROCEEDINGS{10771088,\n  author={Li, Harry and Appleby, Gabriel and Suh, Ashley},\n  booktitle={2024 IEEE Visualization and Visual Analytics (VIS)}, \n  title={LinkQ: An LLM-Assisted Visual Interface for Knowledge Graph Question-Answering}, \n  year={2024},\n  volume={},\n  number={},\n  pages={116-120},\n  keywords={Analytical models;Protocols;Limiting;Data analysis;Visual analytics;Large language models;Data visualization;Knowledge graphs;Writing;Data models;Knowledge graphs;large language models;query construction;question-answering;natural language interfaces},\n  doi={10.1109/VIS55277.2024.00031}\n}\n```\n\n\n## Disclaimer\n\nDISTRIBUTION STATEMENT A. Approved for public release. Distribution is unlimited.\n\n© 2024 MASSACHUSETTS INSTITUTE OF TECHNOLOGY\n\n- Subject to FAR 52.227-11 – Patent Rights – Ownership by the Contractor (May 2014)\n- SPDX-License-Identifier: MIT\n\nThis material is based upon work supported by the Under Secretary of Defense for Research and Engineering under Air Force Contract No. FA8702-15-D-0001. Any opinions, findings, conclusions or recommendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the Under Secretary of Defense for Research and Engineering.\n\nThe software/firmware is provided to you on an As-Is basis.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmit-ll%2Flinkq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmit-ll%2Flinkq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmit-ll%2Flinkq/lists"}