{"data":{"slug":"ther1d-shell-gpt","name":"shell_gpt","tagline":"A command-line productivity tool powered by AI large language models","github_url":"https://github.com/TheR1D/shell_gpt","owner":"TheR1D","repo":"shell_gpt","owner_avatar_url":"https://avatars.githubusercontent.com/u/16740832?v=4","primary_language":"Python","stars":12287,"forks":977,"topics":["chatgpt","cheat-sheet","cli","commands","gpt-3","gpt-4","gpt-5","linux","llama","llm","ollama","openai","productivity","python","shell","terminal"],"archived":false,"github_pushed_at":"2026-07-02T06:03:01+00:00","maintenance_label":"Steady","stars_delta_30d":52,"url":"https://www.graphcanon.com/tools/ther1d-shell-gpt","markdown_url":"https://www.graphcanon.com/tools/ther1d-shell-gpt.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/ther1d-shell-gpt","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=ther1d-shell-gpt","description":"A command-line productivity tool powered by AI large language models like GPT-5, will help you accomplish your tasks faster and more efficiently.","homepage_url":null,"license":"MIT","open_issues":121,"watchers":95,"ai_summary":"ShellGPT is a CLI-based utility that leverages AI LLMs for enhanced task efficiency.","readme_excerpt":"## Installation\n```shell\npip install shell-gpt\n```\nBy default, ShellGPT uses OpenAI's API and GPT-4 model. You'll need an API key, you can generate one [here](https://platform.openai.com/api-keys). You will be prompted for your key which will then be stored in `~/.config/shell_gpt/.sgptrc`. OpenAI API is not free of charge, please refer to the [OpenAI pricing](https://openai.com/pricing) for more information.\n\n> [!TIP]\n> Alternatively, you can run open-source models locally for free. This requires setting up your own LLM backend, such as [Ollama](https://github.com/ollama/ollama). To get ShellGPT working with Ollama, follow this detailed [guide](https://github.com/TheR1D/shell_gpt/wiki/Ollama)\n>\n> **❗️Note that ShellGPT is not optimized for local models and may not work as expected.**\n\n---\n\n# -> docker run -d -p 80:80 -v $(pwd)/index.html:/usr/share/nginx/html/index.html nginx\n\n---\n\n# -> It appears that jq is not installed on the system. Let me try to install it using brew.\n\n---\n\n# -> @FunctionCall execute_shell_command(shell_command=\"brew install jq\")\n\n---\n\n## Docker\nRun the container using the `OPENAI_API_KEY` environment variable, and a docker volume to store cache. Consider to set the environment variables `OS_NAME` and `SHELL_NAME` according to your preferences.\n```shell\ndocker run --rm \\\n           --env OPENAI_API_KEY=api_key \\\n           --env OS_NAME=$(uname -s) \\\n           --env SHELL_NAME=$(echo $SHELL) \\\n           --volume gpt-cache:/tmp/shell_gpt \\\n       ghcr.io/ther1d/shell_gpt -s \"update my system\"\n```\n\nExample of a conversation, using an alias and the `OPENAI_API_KEY` environment variable:\n```shell\nalias sgpt=\"docker run --rm --volume gpt-cache:/tmp/shell_gpt --env OPENAI_API_KEY --env OS_NAME=$(uname -s) --env SHELL_NAME=$(echo $SHELL) ghcr.io/ther1d/shell_gpt\"\nexport OPENAI_API_KEY=\"your OPENAI API key\"\nsgpt --chat rainbow \"what are the colors of a rainbow\"\nsgpt --chat rainbow \"inverse the list of your last answer\"\nsgpt --chat rainbow \"translate your last answer in french\"\n```\n\nYou also can use the provided `Dockerfile` to build your own image:\n```shell\ndocker build -t sgpt .\n```","github_created_at":"2023-01-18T19:40:11+00:00","created_at":"2026-07-15T11:03:00.267607+00:00","updated_at":"2026-09-20T05:11:16.753606+00:00","categories":[{"slug":"inference-serving","name":"Inference & Serving","url":"https://www.graphcanon.com/categories/inference-serving","markdown_url":"https://www.graphcanon.com/categories/inference-serving.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/inference-serving"},{"slug":"llm-frameworks","name":"LLM Frameworks","url":"https://www.graphcanon.com/categories/llm-frameworks","markdown_url":"https://www.graphcanon.com/categories/llm-frameworks.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/llm-frameworks"}],"tags":[{"slug":"chatgpt","name":"chatgpt"},{"slug":"cli","name":"cli"},{"slug":"commands","name":"commands"},{"slug":"productivity","name":"productivity"},{"slug":"python","name":"python"},{"slug":"shell","name":"shell"},{"slug":"terminal","name":"terminal"}],"trust":{"provenance":{"is_fork":false,"github_id":590604203,"owner_type":"User","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-09-20T05:11:13.653Z","maintenance":{"label":"Steady","score":60,"methodology":"github_public_v1","releases_90d":0,"days_since_push":79,"last_release_at":"2026-05-06T04:29:55Z","stars_delta_30d":52,"open_issues_delta_30d":3},"security_summary":{"status":"no_lockfile","scanner":null,"low_count":0,"high_count":0,"last_scan_at":"2026-07-15T11:03:01.872Z","medium_count":0,"scan_profile":"none","critical_count":0}},"capability_facts":{"scan":{"source":"repo_scan","observed_at":"2026-09-20T05:11:14.937Z"},"deploy":{"source":"dockerfile:Dockerfile","self_host":true,"observed_at":"2026-09-20T05:11:14.937Z","managed_saas":false},"has_cli":{"value":true,"source":"pyproject.toml:[project.scripts]","observed_at":"2026-09-20T05:11:14.937Z"},"languages":{"value":["python"],"source":"github.language+pyproject.toml","observed_at":"2026-09-20T05:11:14.937Z"},"has_docker":{"value":true,"source":"dockerfile:Dockerfile","observed_at":"2026-09-20T05:11:14.937Z"},"license_spdx":{"value":"MIT","source":"github.license","observed_at":"2026-09-20T05:11:14.937Z"}},"decision_facts":{"hosting":null,"pricing":null,"requirements":null,"constraints":null,"when_to_use":["When requiring integration with the OpenAI API for advanced CLI tasks","For users preferring paid, premium-model accuracy and real-time updates from OpenAI"],"when_not_to_use":["Avoid if seeking a tool optimized for local-only models like Ollama, which are not fully supported","Not ideal for those aiming to avoid costs associated with the OpenAI API usage fees"],"source":"enrich:decision_facts","observed_at":"2026-07-17T12:13:52.853Z"},"constraint_facets":null,"decision_summary":[{"label":"Adopt for","value":"ShellGPT is an AI-driven CLI utility using LLMs for task efficiency with OpenAI support."}]}}