- Run AI Actions that can manipulate & pull context from your existing tools/editors/apps
- Write & distribute new Actions with a simple Typescript SDK
- Read more here
Download for OS X (Apple Silicon) | Download for OS X (Intel) | Download for Ubuntu | Download for Fedora
- Always-available launcher-style desktop app to run AI actions
- Integrations with VS Code, JupyterLab, PostgreSQL, Chrome, and more!
- Use screenshots in prompts to
gpt-4-vision-preview(✨ new ✨)- Only available for users that provide their own API key
- video
- Long-term memory / Knowledge Base using a local vector DB (
⚠️ pre-release, please report bugs!) - simple Typescript SDK for building new Actions & custom sources of context (Tokens)
To get started, just download the appropriate Lightrail package for your operating system:
- OS X (Apple Silicon / M1 / M2): lightrail-core-osx-arm64.dmg
- OS X (Intel): lightrail-core-osx-x64.dmg
- Ubuntu: lightrail-core.deb
- Fedora: lightrail-core.rpm
- Launch Lightrail initially as you would normally start an application on your platform (i.e. from your application launcher). Consider adding it to your startup items (OS X, Gnome), so that it automatically starts on boot.
- When Lightrail is running on your system, it can be activated at any time by pressing the keyboard combination
Cmd/Ctrl-Shift-Space. - Use the up- and down-arrow keys to browse actions, and hit
enter/returnto select one (while in 'Choose an action' mode). - To change the action afterwards, press
escor@, or click on the current action - After selecting an action, enter the prompt (or any other required arguments). Your prompt can include special Tokens, which pull in additional context from external sources:
- Type the forward-slash at any point in a prompt (
/) to open the Tokens menu. Use the arrow keys to select a token and hit enter to insert that token into your prompt. - In general, try to be explicit about what sources of content you'd like to include for best results.
- Type the forward-slash at any point in a prompt (
Cmd/Ctrl-UpandCmd/Ctrl-Downcycle through the prompt history.- By default, the application uses a lightrail.ai-provided gateway to access OpenAI's LLMs. If you'd like to switch to using your own API key and accessing the OpenAI API directly, you can configure that in Settings (click the gear icon in the prompt input box).
Some common issues, and how to fix them:
- Q: I get
i is not iterableas an error - A: This occurs when the action expects a prompt but one isn't provided. Almost all actions currently available only work if the user has entered a prompt, so make sure you're providing one before you hit
enter/return. - Q: I'm on Linux and the keyboard shortcut to open Lightrail isn't working for me
- A: If you're using Wayland, this is a known bug, caused by this issue. Currently, the only fix is using your system's settings to manually assign a keyboard shortcut to launching Lightrail. If you have any idea how to work-around this bug, I'd love to hear it!
Any other issues? Let me know on Discord or make an issue and I'll address it ASAP!
When creating an issue or describing a but on Discord, please include the contents of the Lightrail log file, available at the following location:
- on Linux:
~/.config/lightrail-core/logs/main.log - on macOS:
~/Library/Logs/lightrail-core/main.log
The lightrail-sdk npm package makes it easy to create additional tracks and extend Lightrail's functionality, or to make Clients that integrate Lightrail with other platforms.
For thorough documentation on creating Tracks & Clients, see our developer documentation here.
We'd love to have your contributions added to Lightrail! If you would like to contribute, please follow this guidelines:
- Fork the repository
- Create a new branch:
git checkout -b feature/my-feature - Make your changes
- Commit your changes:
git commit -m "Add new feature" - Push to the branch:
git push origin feature/my-feature - Submit a pull request
This project is licensed under the MIT License. See the LICENSE file for more details.