{"data":{"slug":"ther1d-shell-gpt","name":"shell_gpt","tagline":"A command-line productivity tool powered by AI large language models like GPT-5, will help you accomplish your tasks faster and more efficiently.","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":12185,"forks":978,"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":"Active","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":115,"watchers":93,"ai_summary":null,"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-07-15T11:03:03.338758+00:00","categories":[{"slug":"computer-vision","name":"Computer Vision","url":"https://www.graphcanon.com/categories/computer-vision","markdown_url":"https://www.graphcanon.com/categories/computer-vision.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/computer-vision"},{"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":"cheat-sheet","name":"cheat-sheet"},{"slug":"cli","name":"cli"},{"slug":"commands","name":"commands"},{"slug":"gpt-3","name":"gpt-3"},{"slug":"gpt-4","name":"gpt-4"},{"slug":"gpt-5","name":"gpt-5"},{"slug":"linux","name":"linux"}],"trust":{"provenance":{"is_fork":false,"github_id":590604203,"owner_type":"User","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-07-15T11:03:01.336Z","maintenance":{"label":"Active","score":82,"methodology":"github_public_v1","releases_90d":1,"days_since_push":13,"last_release_at":"2026-05-06T04:29:55Z"},"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-07-15T11:03:01.078Z"},"deploy":{"source":"dockerfile:Dockerfile","self_host":true,"observed_at":"2026-07-15T11:03:01.078Z","managed_saas":false},"has_cli":{"value":true,"source":"pyproject.toml:[project.scripts]","observed_at":"2026-07-15T11:03:01.078Z"},"languages":{"value":["python"],"source":"github.language+pyproject.toml","observed_at":"2026-07-15T11:03:01.078Z"},"has_docker":{"value":true,"source":"dockerfile:Dockerfile","observed_at":"2026-07-15T11:03:01.078Z"},"license_spdx":{"value":"MIT","source":"github.license","observed_at":"2026-07-15T11:03:01.078Z"}}}}