{"id":29031660,"url":"https://github.com/joshuadeal/clippy-gpt","last_synced_at":"2026-04-27T00:32:11.749Z","repository":{"id":300486807,"uuid":"1006251516","full_name":"joshuaDeal/clippy-gpt","owner":"joshuaDeal","description":"👀📎📃 Clippy resurrected as a ChatGPT front end. 📃📎👀","archived":false,"fork":false,"pushed_at":"2025-06-22T01:15:06.000Z","size":1398,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-22T01:24:15.798Z","etag":null,"topics":["ai","ai-assistant","assistant","chatbot","chatgpt","chatgpt-api","clipit","clippy","desktop-assistant","desktop-pet","intelligent-ui","intelligent-user-interface","openai","openai-api","pyside6","retro","retrotech"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joshuaDeal.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}},"created_at":"2025-06-21T20:43:16.000Z","updated_at":"2025-06-22T01:15:09.000Z","dependencies_parsed_at":"2025-06-22T01:34:31.982Z","dependency_job_id":null,"html_url":"https://github.com/joshuaDeal/clippy-gpt","commit_stats":null,"previous_names":["joshuadeal/clippy-gpt"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/joshuaDeal/clippy-gpt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joshuaDeal%2Fclippy-gpt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joshuaDeal%2Fclippy-gpt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joshuaDeal%2Fclippy-gpt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joshuaDeal%2Fclippy-gpt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joshuaDeal","download_url":"https://codeload.github.com/joshuaDeal/clippy-gpt/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joshuaDeal%2Fclippy-gpt/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262044447,"owners_count":23249750,"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":["ai","ai-assistant","assistant","chatbot","chatgpt","chatgpt-api","clipit","clippy","desktop-assistant","desktop-pet","intelligent-ui","intelligent-user-interface","openai","openai-api","pyside6","retro","retrotech"],"created_at":"2025-06-26T10:04:53.389Z","updated_at":"2026-04-27T00:32:11.744Z","avatar_url":"https://github.com/joshuaDeal.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# clippy-gpt 📎📎📎\nTechnically, his name is **Clippit**.\n\n`clippy-gpt` is an AI powered recreation of everyone's favorite paperclip assistant that came bundled in older versions of the Microsoft Office suite. Clippy hangs out on your desktop, patiently waiting to answer any questions you might encounter. You can read more about the original Clippy [here](https://en.wikipedia.org/wiki/Office_Assistant).\n\nhttps://github.com/user-attachments/assets/078a9933-bde8-41b9-ba49-c847dc447816\n\n## Installation / Configuration\nThere are three ways to take advantage of Clippy's AI functionality.\n\n### Running LLMs Locally\nYour first option would be to download a large language model to run locally, however, it should be noted that in order to do this effectively, you need to have higher-end computer hardware. You can download models in `.gguf` format from websites like [Hugging Face](https://huggingface.co/). You might consider downloading a model like [TinyLlama-1.1B-Chat-v1.0-GGUF](https://huggingface.co/TheBloke/TinyLlama-1.1B-Chat-v1.0-GGUF/resolve/main/tinyllama-1.1b-chat-v1.0.Q5_K_M.gguf) to start out with.\n\n### Using A Service\nAlternatively, you can use either the OpenAI or OpenRouter API to power clippy via an online AI service. You'll need to save an api key in an environmental variable like `OPENAI_API_KEY` or `OPENROUTER_API_KEY`. I have included OpenRouter as an option because it provides some degree of free access to online AI models, unlike OpenAI, which, as of this writing, does not offer any free AI solutions via their API.\n\nIn Linux, you can create a new environmental variable by adding something like `export OPENAI_API_KEY='\u003cYour API Key goes here\u003e'` to your `.bashrc` file. Then, run something like `source ~/.bashrc`.\n\nIn Windows, you can launch `sysdm.cpl` from the `mod + R` menu. On the `Advanced` tab, press the `Environmental Variables` button. From that screen, you can create a new system variable called `OPENAI_API_KEY` and assign it the value of your API key.\n\nIn some setups on both Windows and Linux, a reboot may be needed for these changes to take effect.\n\nYou can download the latest binary from the [releases page](https://github.com/joshuaDeal/clippy-gpt/releases). Make this binary executable, and you should be good to go!\n\n## Usage\n`clippy-gpt`'s behavior can be tweaked via command line arguments.\n\n```\nusage: clippy-gpt [-h] [-l PATH | -a MODEL | -r MODEL]\n\nFriendly paperclip AI assistant.\n\noptions:\n  -h, --help            show this help message and exit\n  -l, --local PATH      Specify file path to local model.\n  -a, --openai MODEL    Specify OpenAI model to use.\n  -r, --openrouter MODEL\n                        Specify OpenRouter model to use.\n```\n\n- `--local PATH` runs using local models. The `PATH` should point to the `.gguf` model you'd like to use.\n- `--openai MODEL`/`--openrouter MODEL` can be used to override the default models used when using these services.\n\nFor example,\n```\nclippy-gpt -r x-ai/grok-4-fast:free\n``` \nwill run using the free version of 'Grok 4 Fast' from OpenRouter.\n\n## Building\n`clippy-gpt` can be built with PyInstaller.\n\nYou'll need to install the dependencies listed in `requirements.txt`. The process may vary depending on how your system is configured, but generally you can do this by running\n\n```\npip install -r requirements.txt\n```\n\nThen, to build, run\n\n```\npyinstaller main.spec\n```\n\nfrom inside of the git repository's root directory.\n\nThis should create a directory called `dist/` inside of which you should see a new binary file.\n\n## Why?\nClippy got a lot of hate in his day, but I always liked the little guy! I have fond memories from the elementary school computer lab, where instead of writing my essays like I should have been, I'd spend entire class periods cycling though all of Clippy's animations and dragging him around the screen to funny positions. Now, I can do that all over again. I suppose I never really grew up much. ¯\\\\\\_(ツ)\\_/¯\n\n## Contributing\nContributions are always welcome! Just open an issue about any bugs/feature requests/etc. If you want to address what you found yourself, fork it to pull request pipeline. I'll merge anything that looks cool. (I'm a bit of a novice when it comes to collaborating on GitHub but I think this is generally what the process looks like.) For anything more nuanced, you can always reach out to me.\n\n## Also See\nThis is a list of projects that proved to be extremely valuable resources when trying to create `clippy-gpt`. I highly recommend you check them out and consider giving them a star or whatever it is people do to show appreciation to a project on GitHub.\n- [clippyjs](https://github.com/pi0/clippyjs) -- The sprite sheet, animation definitions, and sound effects were all sourced from this project.\n- [ClippyVS](https://github.com/tanathos/ClippyVS) -- Clippy in Visual Studio.\n- [Clippy](https://github.com/felixrieseberg/clippy) -- Another Clippy as an AI front-end. This one is set up to work with local LLMs.\n\nAnd then of course, there is the original Clippy from Microsoft Office.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoshuadeal%2Fclippy-gpt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoshuadeal%2Fclippy-gpt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoshuadeal%2Fclippy-gpt/lists"}