Install Gravity and run your first task
Create a free account, download Gravity, connect a model and ask it to read your code. A short, practical walkthrough for Windows 10 and 11.
Gravity is a desktop app: a team of AI agents that can read your files, edit them, run your build and check the result. This guide takes you from nothing to a first working task. It uses the same steps as our documentation, with a few practical notes on the way.
Before you start
You need a Windows 10 or 11 machine (64-bit) with at least 4 GB of RAM. 8 GB or more is recommended. Plan for about 500 MB of disk space for the app and its workspace data.
You also need a model to talk to. Gravity speaks the OpenAI-compatible API, so it works with a local runtime such as Ollama or LM Studio, or with a cloud provider that gives you an API key.
1. Create a free account and download
Create a Gravity account on the website, sign in and open the Download page. Downloading is free for every account. There is no payment step and no card. New accounts also start with a 7-day Pro trial, and after that the account continues on the Free plan.
2. Install
Run the installer (GravitySetup.exe) and follow the wizard. Gravity installs under your local application data folder and can be started from the Start menu or from the desktop shortcut. When the app asks you to sign in at startup, use the account you just created.
3. Connect a model
Open Settings from the ribbon bar, or press Ctrl+Comma. Choose your provider, enter the base URL and, for cloud providers, your API key. Pick a model and press Test Connection. If you want to stay fully local, Ollama defaults to http://localhost:11434 and LM Studio to http://localhost:1234.
Provider : Ollama
Base URL : http://localhost:11434
Model : qwen2.5-coder:7b4. Open a workspace
Open the folder that contains your project. Gravity works on the files in that folder, on your machine.
5. Run a task that is safe to try
Start with something read-only, so nothing in your project changes while you learn how it feels. Type a request in the chat box and press Enter:
Read Program.cs and explain the dependency injection setupGravity reads the file, reasons about it and answers in the chat. Each tool call appears as a collapsible card, so you can open it and see exactly what the agent did. Other good first prompts are:
- List all files in the Controllers folder
- Create a new Razor view for a contact form
- Run dotnet build and show me any errors
What to try next
Once the first answer feels right, switch to a task that edits code, and keep the approval mode on Review so every file write shows you a diff first. The post on approval modes explains the three levels. When you are ready to go deeper, the documentation covers sessions, keyboard shortcuts and custom agents.
Gravity is free to download with an account, so the quickest way to find out if it fits your workflow is to try it on one of your own projects.