# bradleyboy/tuql

Automatically create a GraphQL server from a SQLite database or a SQL file

Repository: https://github.com/bradleyboy/tuql
Canonical: https://ross.abutalabs.com/products/tuql
Language: JavaScript
License: MIT
License Family: permissive
Topics: graphql, sqlite3, sqlite, nodejs, automatic-api, sqlite-database, schema, foreign-keys, sequelize
Last push: 2021-06-06T17:14:12+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3208, "days_push": 1914, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1076, forks 42 (observed 2026-08-28T04:03:29.414530+00:00)

## What it is
tuql is a Node.js CLI tool that automatically spins up a GraphQL server from a SQLite database or SQL dump file. It infers models and relationships (belongsTo, hasMany, belongsToMany) from foreign keys or naming conventions, and generates queries plus CRUD mutations.

## Use cases
- expose a sqlite database as a graphql api
- create a graphql server from a sql dump file
- generate a graphql schema from an existing database
- quickly prototype a graphql backend without writing resolvers
- explore relational data with graphiql
- infer hasMany and belongsToMany relationships from foreign keys

## When to choose
- you have a well-structured SQLite database and want a GraphQL API with zero configuration
- you want to quickly inspect or prototype against a SQL dump via GraphQL
- you need an auto-generated schema with mutations for create, update, and delete

## When to avoid
- your database is not SQLite
- you need production-grade control over resolvers, auth, or performance
- your schema doesn't follow conventional primary/foreign key naming and lacks declared foreign keys
- you need active development or long-term support

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: graphql, api-framework, http-server, database
- domain: databases, apis, web-development, developer-tools
- platform: cli, cross-platform
- tags: sqlite, graphql-server, schema-inference, automatic-api, sequelize, graphiql, nodejs

## Member repositories
- bradleyboy/tuql (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:29.414530+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:53:21.162743+00:00, confidence not recorded.
  - readme: https://github.com/bradleyboy/tuql (fetched 2026-08-28T04:03:29.414530+00:00, sha ad8768ccad7c)
- Data as of 2026-08-30T08:39:29.467469+00:00.