Skip to content

Hy4ri/antigravity-flake

Repository files navigation

Google Antigravity Nix Flake

A clean, multi-platform Nix Flake for packaging the complete Google Antigravity AI engineering suite: the CLI, Desktop Hub, Desktop IDE, and Python SDK.

Exposed Packages

This flake packages and exposes five primary targets supporting both Linux (x86_64-linux, aarch64-linux) and macOS (x86_64-darwin, aarch64-darwin):

  1. antigravity-cli (default) - The Go-based Antigravity command-line utility (provides command agy).
  2. antigravity - The Antigravity Desktop Hub (provides command antigravity).
  3. antigravity-ide - The Antigravity Desktop IDE (provides command antigravity-ide).
  4. antigravity-fhs - Wrapped IDE launched in a FHS compatible environment (provides conflicting command antigravity-ide, making it mutually exclusive/uninstallable together with the standard IDE package).
  5. antigravity-sdk - The Python SDK containing precompiled, auto-patched localharness binaries for agent interaction.

Quick Start (No Installation)

You can run any part of the Antigravity suite immediately without modifying your system configuration:

Run the CLI

nix run github:Hy4ri/antigravity-flake
# Or explicitly:
nix run github:Hy4ri/antigravity-flake#antigravity-cli

Run the Desktop Hub

nix run github:Hy4ri/antigravity-flake#antigravity

Run the Desktop IDE

nix run github:Hy4ri/antigravity-flake#antigravity-ide
# Or run with the FHS wrapper (Linux only):
nix run github:Hy4ri/antigravity-flake#antigravity-fhs

Installation & Integration

1. Declaring packages in NixOS / Home Manager

Add antigravity-flake to your flake inputs:

inputs = {
  nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
  antigravity.url = "github:Hy4ri/antigravity-flake";
};

Then add the packages to your system or home packages:

environment.systemPackages = [
  inputs.antigravity.packages.${pkgs.system}.antigravity-cli
  inputs.antigravity.packages.${pkgs.system}.antigravity
  inputs.antigravity.packages.${pkgs.system}.antigravity-ide
];

2. Using the Python SDK in a DevShell

If you are developing Python agents, you can easily load the precompiled and auto-patched Python SDK into a nix development shell:

devShells.default = pkgs.mkShell {
  packages = [
    (pkgs.python3.withPackages (ps: [
      inputs.antigravity.packages.${pkgs.system}.antigravity-sdk
    ]))
  ];
};

3. Using Overlays

To globally inject these packages into your nixpkgs instance, apply the overlay:

nixpkgs.overlays = [
  inputs.antigravity.overlays.default
];

License

Proprietary binaries downloaded and packaged under the Google Antigravity License Terms.

Contributors