The open-source, cross-platform API client for GraphQL, REST, WebSockets and gRPC.
Insomnia API Client
Insomnia is an open-source, cross-platform API client for GraphQL, REST, WebSockets, Server-sent events (SSE), gRPC and any other HTTP compatible protocol.
With Insomnia you can:
And a lot more! The following storage options are supported for your projects, collections, specs and all other files:
Get started
Insomnia is available for Mac, Windows, and Linux and can be downloaded from the website:
https://insomnia.rest/download
Account & Subscriptions
You can use Insomnia without an account with Scratch Pad, or you can create an account for free to get access to the full capabilities of the product.
Even with an account, Insomnia only stores your projects and files accordingly to the storage backend that you have selected, which can be Local Vault, Cloud Sync, Git Sync or any combination of them. As such you have the freedom to choose to store sensitive projects locally, while still being able to collaborate on others in the cloud or on Git. It's the best of both worlds.
Premium features and support
Kong Inc. offers commercial subscriptions that enhance Insomnia in a variety of ways. Some of those features include the ability to create organizations for your projects, Enterprise SSO with SAML and OIDC, RBAC when sharing our projects with others, AI capabilities to increase developer productivity when creating, testing and documenting APIs and a lot more.
You can explore all premium plans and get started for free.
Bugs and Feature Requests
Have a bug or a feature request? First, read the issue guidelines and search for existing and closed issues. If your problem or idea is not addressed yet, please open a new issue.
For more generic product questions and feedback, join the Slack Team.
Contributing
Please read through our contributing guidelines and code of conduct. Included are directions for opening issues, coding standards, and notes on development.
Documentation
Check out our open-source Insomnia Documentation.
Develop Insomnia
Development on Insomnia can be done on Mac, Windows, or Linux as long as you have Node.js and Git. See the .nvmrc
file located in the project for the correct Node version.
Initial Dev Setup
This repository is structured as a monorepo and contains many Node.JS packages. Each package has its own set of commands, but the most common commands are available from the root package.json
and can be accessed using the npm run …
command. Here are the only three commands you should need to start developing on the app.
# Install and Link Dependencies npm iLinuxRun Lint
npm run lint
Run type checking
npm run type-check
Run Tests
npm test
Start App with Live Reload
npm run dev
If you are on Linux, you may need to install the following supporting packages:
Ubuntu/Debian
# Update library sudo apt-get updateInstall font configuration library & support
sudo apt-get install libfontconfig-dev
Fedora
# Install libcurl for node-libcurl sudo dnf install libcurl-devel
Also on Linux, if Electron is failing during the install process, run the following
# Clear Electron install conflicts rm -rf ~/.cache/electronWindows
If you are on Windows and have problems, you may need to install Windows Build Tools
Editor Requirements
You can use any editor you'd like, but make sure to have support/plugins for the following tools:
Develop Inso CLI
npm i
npm run inso-start
./packages/insomnia-inso/bin/inso -v
Plugins
Search for, discover, and install plugins from the Insomnia Plugin Hub!
Community Projects
License
Twice a month we will interview people behind open source businesses. We will talk about how they are building a business on top of open source projects.
We'll never share your email with anyone else.