explaingit

tinyfish-io/bigset

Analysis updated 2026-05-18

32TypeScriptAudience · developerComplexity · 3/5LicenseSetup · easy

TLDR

A tool that builds a live, queryable dataset from a plain English description, keeps it automatically fresh, and lets you query it with SQL.

Mindmap

mindmap
  root((BigSet))
    What it does
      Plain English to dataset
      Auto refreshing data
      SQL queryable
    Tech stack
      TypeScript
      Next.js
      Fastify
      PostgreSQL
    Use cases
      Replace web scrapers
      Feed AI agents fresh data
      Self hosted datasets
    Features
      Self healing collector
      Scheduled refresh
      TinyFish APIs
    Audience
      Developers
      Agent builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Describe a dataset in plain English and have BigSet collect and structure it automatically.

USE CASE 2

Query a continuously refreshed dataset with SQL from your own application or AI agents.

USE CASE 3

Replace a hand-built web scraper and cron job pipeline with a self-healing data collector.

USE CASE 4

Self-host a live dataset that updates on a schedule you control, like every 30 minutes or hourly.

What is it built with?

TypeScriptNext.jsReactFastifyPostgreSQL

How does it compare?

tinyfish-io/bigsetalexmt/mobile-for-argocdjavlonbek1233/-neonbite
Stars323232
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderateeasy
Complexity3/53/51/5
Audiencedeveloperops devopsvibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Docker and Make, one command starts the database, backend, and frontend together.

You can use, modify, and self-host BigSet, but if you run a modified version as a network service, you must also make your changes' source code available under the same AGPL license.

In plain English

BigSet is a tool that lets you describe a dataset you want in plain English, and it builds that dataset for you, keeps it up to date automatically, and lets you query it using SQL, a standard language for asking questions about structured data. Think of it like a self-filling spreadsheet: instead of manually collecting data from different sources or writing your own scraper, you tell BigSet what you want, such as companies currently hiring, insurance quotes in your area, or restaurants near you that serve a specific brand, and it goes out and gathers that data for you. Once the dataset exists, BigSet keeps it fresh on a schedule you choose, refreshing every 30 minutes, every hour, or whatever interval fits your needs. A built in healer feature watches for data sources that break, for example when a website changes its layout, and tries to patch the collection process automatically before you notice a problem. The collected data lives in a database, so both you and any automated agents you build can query it with SQL at any time. Under the hood, BigSet is built on TinyFish's own data collection APIs for search, fetching pages, and browser automation. The rest of the stack uses Next.js and React for the web interface, Fastify and TypeScript for the backend API, and PostgreSQL through the Drizzle ORM for storage, with a self-hosted email and password login system. Getting it running locally just requires Docker and Make: cloning the repository and running one command starts the database, backend, and frontend together. BigSet is aimed at developers and teams who are tired of building and maintaining web scrapers and data pipelines by hand, especially those building AI agents that need a steady, queryable supply of fresh data. It is an open-source, self-hosted project that is still being actively built, and the project welcomes contributions and feedback from anyone using it.

Copy-paste prompts

Prompt 1
Explain how BigSet turns a plain English description of a dataset into a queryable SQL table.
Prompt 2
Walk me through running BigSet locally with Docker and Make, and what services it starts up.
Prompt 3
Explain what the healer feature does when a data source BigSet depends on breaks.
Prompt 4
Show me how an AI agent could query a BigSet dataset with SQL to get fresh data.

Frequently asked questions

What is bigset?

A tool that builds a live, queryable dataset from a plain English description, keeps it automatically fresh, and lets you query it with SQL.

What language is bigset written in?

Mainly TypeScript. The stack also includes TypeScript, Next.js, React.

What license does bigset use?

You can use, modify, and self-host BigSet, but if you run a modified version as a network service, you must also make your changes' source code available under the same AGPL license.

How hard is bigset to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is bigset for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.