{"id":16277966,"url":"https://github.com/rpidanny/shellygpt","last_synced_at":"2025-10-03T23:09:02.192Z","repository":{"id":159130966,"uuid":"633483088","full_name":"rpidanny/ShellyGPT","owner":"rpidanny","description":"A command-line tool that ingests documents and generates instant answers to your questions about those documents using ChatGPT, giving you the Sheldon Cooper you never had at your fingertips.","archived":false,"fork":false,"pushed_at":"2023-08-19T16:25:42.000Z","size":1819,"stargazers_count":8,"open_issues_count":13,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-09-16T19:31:34.739Z","etag":null,"topics":["chat-gpt","gpt","gpt-3","gpt-3-5","gpt-4","llm","milvus","openai","pinecone","shelly","vector-store"],"latest_commit_sha":null,"homepage":"","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/rpidanny.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2023-04-27T15:40:30.000Z","updated_at":"2023-10-19T09:51:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"f7d20d9f-4e35-4a4f-8cfa-0648b069e6e4","html_url":"https://github.com/rpidanny/ShellyGPT","commit_stats":null,"previous_names":["rpidanny/shelly"],"tags_count":33,"template":false,"template_full_name":null,"purl":"pkg:github/rpidanny/ShellyGPT","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rpidanny%2FShellyGPT","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rpidanny%2FShellyGPT/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rpidanny%2FShellyGPT/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rpidanny%2FShellyGPT/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rpidanny","download_url":"https://codeload.github.com/rpidanny/ShellyGPT/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rpidanny%2FShellyGPT/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278239985,"owners_count":25954098,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-03T02:00:06.070Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["chat-gpt","gpt","gpt-3","gpt-3-5","gpt-4","llm","milvus","openai","pinecone","shelly","vector-store"],"created_at":"2024-10-10T18:56:54.052Z","updated_at":"2025-10-03T23:09:02.171Z","avatar_url":"https://github.com/rpidanny.png","language":"TypeScript","readme":"Shelly :robot:\n=================\n\n\u003cp align=\"left\"\u003e\n  \u003cimg src=\"sheldon_mid.png\" height=\"200\"\u003e\n\u003c/p\u003e\n\nWelcome to Shelly - the coolest CLI tool around! Ingesting documents and generating instant answers to questions about those documents using ChatGPT, Shelly provides you with the Sheldon Cooper you never had at your fingertips.\n\n\u003c!-- toc --\u003e\n* [What is Shelly?](#what-is-shelly)\n* [Demo](#demo)\n* [Features](#features)\n* [Installation](#installation)\n* [Configuration](#configuration)\n* [Usage](#usage)\n* [Command Topics](#command-topics)\n* [Data Collection and Analytics](#data-collection-and-analytics)\n* [License](#license)\n\u003c!-- tocstop --\u003e\n\n# What is Shelly?\n\nShelly is a command-line tool that ingests documents into a vector store and generates instant answers to your questions about those documents using ChatGPT. Inspired by the iconic character of Sheldon Cooper from The Big Bang Theory, Shelly brings a fun and quirky vibe to your command-line experience.\n\nWith Shelly, you can have the genius mind of Sheldon Cooper at your fingertips, answering all your queries with its powerful GPT-based algorithms. Gone are the days of tirelessly searching for answers, as Shelly provides you with accurate solutions using its advanced machine learning technology.\n\n# Demo\n\n## The Big Bang Theory Trivia\n\nhttps://user-images.githubusercontent.com/6696862/235325240-ba6df010-d238-411e-b137-55cfea249d2c.mov\n\n## Code: Class Validator\n\nhttps://user-images.githubusercontent.com/6696862/235344589-c7eaad37-049e-4b63-a89b-e143d81354ca.mov\n\n# Features\n\n- [x] Ingest documents and allows answering questions about those documents\n- [x] Web UI\n\n# Installation\n\nTo get started with Shelly, you can install it via npm using the following command:\n\n```bash\nnpm i -g @rpidanny/shelly\n```\n\nAlternatively, you can download installers for `Windows`, `Linux`, and `macOS` from the [release page](https://github.com/rpidanny/shelly/releases).\n\n# Configuration\n\nAfter installing Shelly, you need to configure it using the following command:\n\n```bash\nshelly configure\n```\n\nThis command will prompt you to add your OpenAI keys and vector store configurations. \n\n## Vector Store Options\n\nShelly supports two options for the vector store:\n\n1. [Pinecone](https://www.pinecone.io/)\n2. [Milvus](https://milvus.io/)\n\nWe recommend using **Milvus**, as it offers an API key-free experience and has no limitations on the number of collections you can create.\n\nTo get started with Milvus, you can easily create a local instance by running `shelly milvus start` or by using the provided Docker Compose file located at `docker/milvus/docker-compose.yml`.\n\n```bash\ncd docker/milvus\ndocker-compose up -d\n```\n\n# Usage\n\u003c!-- usage --\u003e\n```sh-session\n$ npm install -g @rpidanny/shelly\n$ shelly COMMAND\nrunning command...\n$ shelly (--version)\n@rpidanny/shelly/1.14.1 linux-x64 node-v18.16.0\n$ shelly --help [COMMAND]\nUSAGE\n  $ shelly COMMAND\n...\n```\n\u003c!-- usagestop --\u003e\n\u003c!-- commands --\u003e\n# Command Topics\n\n* [`shelly ask`](docs/ask.md) - Ask questions or instruct shelly to do something.\n* [`shelly config`](docs/config.md) - Get currently set configs\n* [`shelly configure`](docs/configure.md) - Configure shelly\n* [`shelly events`](docs/events.md) - Create iCal events\n* [`shelly help`](docs/help.md) - Display help for shelly.\n* [`shelly history`](docs/history.md) - Print history\n* [`shelly ingest`](docs/ingest.md) - Ingest directory to a vector store\n* [`shelly milvus`](docs/milvus.md) - Start local Milvus vector store\n* [`shelly serve`](docs/serve.md) - start the Shelly web service\n\n\u003c!-- commandsstop --\u003e\n\n# Data Collection and Analytics\n\nThis CLI app only collects essential data for analytics purposes to improve user experience. The information collected includes:\n\n- User's operating system (OS) details (e.g., version, architecture, type)\n- App metadata (e.g version, name)\n- Id of the command used.\n\n# License\n\nShelly is released under the MIT License. See the [LICENSE](LICENSE) file for details.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frpidanny%2Fshellygpt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frpidanny%2Fshellygpt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frpidanny%2Fshellygpt/lists"}