{"id":27302401,"url":"https://github.com/steinathan/shai","last_synced_at":"2025-07-05T09:06:32.505Z","repository":{"id":230631138,"uuid":"779842869","full_name":"steinathan/shai","owner":"steinathan","description":"shai is a command line utility that allows you to interact with your computer using natural language.","archived":false,"fork":false,"pushed_at":"2024-03-31T00:08:37.000Z","size":171,"stargazers_count":23,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-12T02:38:55.917Z","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/steinathan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-03-30T23:46:22.000Z","updated_at":"2024-10-03T02:40:31.000Z","dependencies_parsed_at":"2024-03-31T01:22:34.869Z","dependency_job_id":"7664210c-90c6-46fa-8d5a-b32c52fd6507","html_url":"https://github.com/steinathan/shai","commit_stats":null,"previous_names":["navicstein/shai","steinathan/shai"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steinathan%2Fshai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steinathan%2Fshai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steinathan%2Fshai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steinathan%2Fshai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/steinathan","download_url":"https://codeload.github.com/steinathan/shai/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248507239,"owners_count":21115562,"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","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":"2025-04-12T02:39:01.870Z","updated_at":"2025-04-12T02:39:06.933Z","avatar_url":"https://github.com/steinathan.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# shai\n\nshai is a command line utility that allows you to interact with your computer using natural language. Simply write what you want to do, and shai will generate the necessary command to make it happen.\n\nshai is built on top of LangChain and LiteLLM libraries, and uses the Typer framework for the interactive CLI.\n\n# Images\n\n\u003cimg src=\"./screenshots/scrsht1.png\"\u003e\n\u003cimg src=\"./screenshots/scrsht2.png\"\u003e\n\u003cimg src=\"./screenshots/scrsht3.png\"\u003e\n\n# Features\n\nshai uses LiteLLM which mean that you can use any model/provider of your choice, you can even use local models provider, eg. Ollama\n\n- Use any provider of your choice, eg. Ollama, Groq, Together, OpenAI, etc.\n- Can execute shell command (coming soon)\n- Can run Offline without internet\n- Can run on any OS - thanks to Python\n- Uses LangChain - An open-source library to simplify LLM calls.\n- Uses LiteLLM - An open-source library to simplify LLM completion + embedding calls.\n- Uses Typer - the interactive CLI\n\n## Installation\n\nshai is a python package built with poetry, so you can install it using poetry:\n\n\u003e for now i'll recommend you clone the repo then install with poetry,\n\n```bash\n$ gh repo clone navicstein/shai\n$ cd shai\n$ poetry env use python3.11 \u0026\u0026 poetry shell (or source $(poetry env info --path)/bin/activate)\n$ poetry install\n```\n\n\u003c!-- ```bash\n$ poetry add \"git+https://github.com/navicstein/shai.git\"\n``` --\u003e\n\n## Configuration (coming soon)\n\nshai is still pending, but in the meantime, please see `.env.example`\n\n## Usage\n\nYou can drop right into the Repl by running:\n\n```bash\n$ shai shell\n```\n\nthen proceed to tell it what you want to do.\n\nexample commands are:\n\n- shutdown my pc in 4 hours\n- copy all mp3 files from my downloads to my music folder\n- find all text files that has \"hello world\", then move them to my downloads folder\n- search for \"hello world\" in all text files in my downloads folder and move them to my music folder\n- move all video file on my desktop to my downloads\n\n### Explain command (coming soon)\n\n```bash\n$ shai explan \"grep -rl 'hello world' /home/user/Downloads/*.txt | xargs -I {} mv {} /home/user/Music\"\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsteinathan%2Fshai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsteinathan%2Fshai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsteinathan%2Fshai/lists"}