Skip to content
FraiseQL v2.0.0-alpha

Installation

FraiseQL is distributed as a pre-compiled Rust binary — no runtime, no dependencies. Download and run.

Requirements

Section titled “Requirements”
  • Database: PostgreSQL (recommended), MySQL, SQLite, or SQL Server
  • Schema SDK: Python 3.10+, Node.js 18+, Go 1.21+, or others

Install FraiseQL

Section titled “Install FraiseQL”
Terminal window
curl -fsSL https://fraiseql.dev/install.sh | sh

This installs the latest binary to /usr/local/bin (or ~/.local/bin if that is not writable).

Install the Schema SDK

Section titled “Install the Schema SDK”

The schema SDK lets you define GraphQL types in your preferred language.

SDK Maturity

Section titled “SDK Maturity”
LanguageStatusStartersDocs
Python✅ Stableminimal · blog · saas · authFull
TypeScript✅ StableminimalFull
Go🧪 Community preview—Minimal
Java🧪 Community preview—Minimal
PHP🧪 Community preview—Minimal

Python and TypeScript are the recommended starting points. Go, Java, and PHP SDKs exist and can declare schema types, but have fewer examples and less documentation coverage.

Terminal window
# uv (recommended)
uv add fraiseql


# pip
pip install fraiseql

Requires Python 3.10+.

Verify Installation

Section titled “Verify Installation”
Terminal window
fraiseql --version

Expected output:

fraiseql 2.0.0

Set Up Your Database

Section titled “Set Up Your Database”
Terminal window
# Create a database
createdb myapp


# Set the connection string
export DATABASE_URL="postgresql://localhost:5432/myapp"

PostgreSQL gives you the best JSON support and is the recommended database for new projects.

Initialize a Project

Section titled “Initialize a Project”

  1. Create a new project:

    Terminal window
    fraiseql init my-api
    cd my-api

  2. Review the generated structure:

    my-api/
    ├── fraiseql.toml      # Project configuration
    ├── schema/
    │   └── schema.py      # Schema definition (or .ts / .go)
    └── sql/
        ├── tables/        # Table DDL
        └── views/         # View definitions

  3. Set your database URL and verify the connection:

    Terminal window
    export DATABASE_URL="postgresql://localhost:5432/myapp"
    fraiseql db check

    Expected output:

    ✓ Connected to PostgreSQL 16.1
    ✓ Database "myapp" accessible

IDE Setup

Section titled “IDE Setup”

VS Code

Section titled “VS Code”
.vscode/extensions.json
{
  "recommendations": [
    "ms-python.python",
    "tamasfe.even-better-toml",
    "graphql.vscode-graphql"
  ]
}

PyCharm / IntelliJ

Section titled “PyCharm / IntelliJ”

FraiseQL works out of the box with PyCharm’s Python support. Install the TOML plugin for fraiseql.toml syntax highlighting.

Docker

Section titled “Docker”
Dockerfile
FROM debian:bookworm-slim


RUN apt-get update && apt-get install -y curl && \
    curl -fsSL https://fraiseql.dev/install.sh | sh && \
    rm -rf /var/lib/apt/lists/*


COPY . /app
WORKDIR /app


RUN fraiseql compile
CMD ["fraiseql", "run", "--host", "0.0.0.0"]

Troubleshooting

Section titled “Troubleshooting”

“command not found: fraiseql” — Add ~/.local/bin to your PATH:

Terminal window
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

“database connection refused” — Verify your database is running and check DATABASE_URL:

Terminal window
fraiseql db check

Permission errors on Linux — Make the binary executable:

Terminal window
chmod +x ~/.local/bin/fraiseql

Next Steps

Section titled “Next Steps”