Skip to content
Navigation Menu
Product
Solutions
Resources
Open Source
Enterprise
Pricing

Search or jump to...
Sign in
Sign up
XInTheDark
/
raycast-g4f
Public
Code
Issues
7
Pull requests
1
Discussions
Actions
Projects
Wiki
Security
Insights
XInTheDark/raycast-g4f
Go to file
Name		
XInTheDark
XInTheDark
Add Llama-3.3-70B to DDG provider
d191e43
 · 
last week
.github
Add GitHub issue templates
7 months ago
assets
Update logo and icons (#133)
4 months ago
src
Add Llama-3.3-70B to DDG provider
last week
.eslintrc.json
Update Google Gemini models to exp-0827, update ESLint config
6 months ago
.gitignore
Preferences rework (#167)
2 months ago
.prettierrc
Initial commit
10 months ago
LICENSE.txt
Create LICENSE.txt
10 months ago
Privacy.md
Add Mhystical provider (#152)
3 months ago
README.md
Update README
last month
package-lock.json
Increase version number to v5.3
2 weeks ago
package.json
Increase version number to v5.3
2 weeks ago
requirements.txt
Fix DuckDuckGo web search (#147)
3 months ago
Repository files navigation
README
GPL-3.0 license
Raycast-G4F (GPT4Free)
Use the powerful GPT-4, Llama-3 and more AI models on Raycast, for FREE! + Full support for custom APIs.

Homepage · Privacy Policy · FAQs · Discord

Screenshots
1 2 3 4
Getting Started
"If you like the extension, please consider giving it a ✨star✨ tysm!" - the developer, probably

Prerequisites
Install the Raycast app.
Currently, Raycast is only available for macOS. Windows support is in progress.
Install Node.js.
The minimum version recommended is v20.18.1. If you're using an older version, you may encounter issues.
Installation
This extension is currently not available on the Raycast Extension store, but installation from source is extremely simple.

Download the source code from the latest release, or clone the repository.
Navigate to the directory, and open a Terminal window at the downloaded folder.
Run npm ci --production to install required dependencies.
(Optional) Run pip3 install -r requirements.txt to install Python dependencies. These are required for some features, e.g. web search.
Run npm run dev to build and import the extension.
The extension, and its full set of commands, should then show up in your Raycast app.

Troubleshooting
Please open an issue if any unexpected problems occur during installation.

Updating
Automatically
There is built-in support for updating within the extension itself! Simply run the "Check for Updates" command in the extension, and it will take care of the update process for you. Furthermore, the "Automatically Check for Updates" feature is available in the preferences (enabled by default).

Manually
In the command line, run git pull, npm ci --production and npm run dev (in that order).

You might want to update manually if the automatic update doesn't work (please also open a GitHub issue if this is the case); updating manually also allows you to fetch and view the latest changes to the source code.

Summary
▶️️ Streaming support - see messages load in real-time, providing a seamless experience.
⚡ Ask anything from anywhere - with 18 commands available, there's something for you no matter what you need.
💪 Support for many providers & models (more info below!)
💬 Chat command - interact with the AI in a conversation, and your chat history will be stored in the extension.
🌐 Web search - let GPT search the web for the latest information.
📄 File upload - you can upload image, video, audio and text files to the AI. (only available for a few providers, more to come!)
🎨 Image generation capabilities - imagine anything, and make it reality with state-of-the-art models.
✏️ Custom AI Commands - create your own commands with custom prompts!
Providers & Models
List of built-in providers
Custom APIs
The extension fully supports custom APIs! You can use any OpenAI-compatible API and connect it.

Get started by reading the help page.

Provider-specific notes
Google Gemini: An API Key is required to use this model. You can get one completely for free:
Go to https://aistudio.google.com/app/apikey
Sign in to your Google account if you haven't done so.
Click on "Create API Key" and follow the instructions there.
Copy the API Key and paste it into the corresponding box in the extension preferences.
The rate limit for Google Gemini is 1500 requests per day (as of the time of writing). This should be much more than enough for any normal usage. If your use case needs an increased rate limit, you can even create multiple API Keys with different Google accounts; separate them with commas in the preferences.

Google Gemini: This provider supports File upload functionality, as well as the Ask About Screen Content command! To upload a file in AI Chat, press Command-Enter or select "Compose Message" from the actions. Then, simply click on the upload button to get started.
Features
Note

As of v5.0, the extension preferences are now found in the "Preferences" command. Please use this command to access the preferences instead of the Raycast preferences.

Web Search
Let GPT decide to search the web for information if it does not have enough knowledge or context. Uses DuckDuckGo search, fast and free.

Usage
Enabling web search is fast and easy. Go to the extension preferences, and the "Web Search" option will be available. There are 4 options:

Disabled (default)
Automatic: Enable Web Search only in AI Chat. GPT will automatically decide when to use it.
Balanced: Use Web Search in every query for AI commands¹, and automatically in AI Chat. This is basically an extension of the "Automatic" option.
Always: Always use Web Search for every query, both in AI Chat and in commands¹.
¹: Commands that support Web Search are: Ask AI, Ask About Selected Text, Explain. Other commands will not use Web Search.

Web Search is also available in the following commands:

Custom AI Commands: You can enable Web Search for each command individually.
AI Chat: You can enable Web Search for each chat individually.
AI Presets: You can enable Web Search for each preset individually.
Smart Chat Naming
Let GPT automatically come up with a name for the current chat session after you send the first message. For example, this is similar to what the ChatGPT web UI does.

Automatically Check for Updates
Let the extension automatically check for updates every day. If a new version is available, you will be notified, along with the option to update the extension with a single click.

Persistent Storage
Enable more persistent storage of the extension's data, like AI Chat data or Custom Commands. This will back up a copy of this data to files on your computer. Useful for saving large amounts of data. Note: With this option off, your data is already well preserved. Do not enable this if you have sensitive data.

Enable Cursor Icon
Show a cursor icon when the response is loading - cosmetic option only.

Code Interpreter (BETA)
Allows GPT to execute Python code locally. The model has been instructed to strictly only produce safe code, but use at your own risk!

Only models with function calling capabilities support this feature. Currently, this includes only selected DeepInfra models.

FAQs
Why is this extension not on the official Raycast store?
By default, this extension comes with a number of third-party providers which you can use for free. Raycast doesn't like that because it's not possible to entirely verify the quality of these providers. (I do provide all the privacy details here, though, and the extension is open-source.) ...and also because they're selling their own AI.
Also, for me as a developer, publishing updates to the Raycast store is too slow and troublesome; I have to submit a PR, wait a week for it to be reviewed, and possibly have it rejected. This is not a good experience for me or for users.
Thus, the extension will have to be installed from source. Regarding this, I apologize as it's indeed more complicated than downloading it from the store. I have tried my best to make the installation process quick and streamlined - please do provide feedback on whether it was simple enough!
How does this extension compare to the paid Raycast AI? Why should I use this instead?
I’ve noticed many users subscribing to Raycast AI, which is quite expensive, and then only using it for a few casual chats a day. Honestly, that’s unnecessary. Here’s my honest suggestion: Everyone should first try out raycast-g4f. Here’s why:

Freedom. You get to choose whatever provider/API to use, and can even add multiple at once. OpenAI, Anthropic, Google… basically any API out there. (“Can I use my OpenAI API Key in Raycast AI?” No, you can’t.) That also means your AI access isn’t just locked inside Raycast. (“Can I use my Raycast AI in other apps?” No, you can’t.)
Price. This extension is completely free to use if you're sticking with the built-in providers. And if you want to use your own API, you pay only for what you use. That’s cheaper than raycast AI. There is no fixed price - you can choose whatever provider you want. You can even run models locally and connect them to the extension.
Privacy. The extension is open source and it respects your privacy. Everything is stored only on your device, and you choose what data you send.
Why is the UI worse than Raycast AI?
Because the developer API that Raycast provides is limited, it's not possible to replicate the Raycast AI interface exactly. The components I can use are very simple, and a lot of the features in built-in Raycast commands are not available to extension developers.
However, I've spent a lot of effort trying to make the UI really intuitive, and I'm always open to feedback on how to improve it!
The extension isn't working! (e.g. I sent a message but there is no response)
Sometimes third party providers can be slow or unresponsive. If you're experiencing this issue, please try again in a few minutes; or if the problem persists, please try switching to another provider.
If you've tried various providers and the issue still persists, please open an issue on GitHub!
How do I contribute to the extension?
I welcome all contributions! If you have an idea for a new feature, or if you've found a bug, please open an issue.
If you'd like to contribute code, please open a pull request, and I'll make sure to review it as soon as possible.
Star History
Star History Chart

License & Acknowledgements
License: GPLv3. Full license is found in LICENSE.txt.

The code base is derived from Raycast Gemini by Evan Zhou.

Third-party libraries used for generation:

g4f-image
gemini-ai-sdk
(Both packages are maintained by the extension author.)

Some of the code in this repository was inspired or ported from the original gpt4free project (written in Python).

About
Raycast extension to use GPT, Claude, Llama, and more... all for FREE! + Full support for custom APIs.

Topics
chatbot gemini gpt claude gpt-4 raycast-extension chatgpt free-gpt gpt4free llama3 gpt-4o
Resources
 Readme
License
 GPL-3.0 license
 Activity
Stars
 715 stars
Watchers
 9 watching
Forks
 55 forks
Report repository
Releases 48
v5.3
Latest
2 weeks ago
+ 47 releases
Packages
No packages published
Languages
JavaScript
99.5%
 
Shell
0.5%
Footer
© 2025 GitHub, Inc.
Footer navigation
Terms
Privacy
Security
Status
Docs
Contact
Manage cookies
Do not share my personal information
Release v5.3 · XInTheDark/raycast-g4f · GitHub