Skip to content

In-browser data warehouse powered by DuckDB-WASM. SQL analytics without servers - your data never leaves the browser.

License

Notifications You must be signed in to change notification settings

Saadain23/duckbase

Repository files navigation

Duckbase Logo

Duckbase - In Browser Data Warehouse

Website GitHub stars License TypeScript Next.js

πŸš€ Advanced Browser-Native Data Analytics

Duckbase is a powerful in-browser data warehouse that transforms how you work with data. Built on DuckDB-WASM for high-performance OLAP (Online Analytical Processing), Duckbase delivers professional-grade analytics capabilities directly in your browser - no cloud setup, no database installation, no data leaving your device.

⚑ Why Duckbase Outperforms Traditional Browser Solutions

  • πŸ”₯ Significantly Faster than Google Sheets for large datasets (overcoming the 10M cell limitation)
  • πŸ›‘οΈ 100% Private - Your data never leaves your browser
  • πŸ’Ύ Zero Infrastructure - No database setup or server configuration required
  • πŸ€– AI-Enhanced - Smart SQL generation with cutting-edge language models
  • πŸ“Š Real-time Analytics - Fast insights on substantial datasets

✨ Key Features

πŸ—οΈ Professional-Grade Data Warehouse in Your Browser

  • DuckDB-WASM Engine: High-performance analytical database running natively in WebAssembly
  • OLAP Performance: Efficiently handle large datasets with fast query response times
  • Memory-Efficient: Process substantial datasets using optimized streaming algorithms
  • Browser-Native: Full SQL capabilities without server dependencies

Technical Advantages Over Spreadsheet Tools

  • No Cell Limits: Unlike Google Sheets' cell restriction, process larger datasets seamlessly
  • SQL Power: Full analytical SQL capabilities vs. limited spreadsheet formulas
  • Columnar Processing: Optimized for analytical workloads vs. row-based spreadsheet or databases
  • Data Type Optimization: Native support for complex data types and structures

πŸ€– AI-Powered SQL Assistant

  • OpenRouter Integration: Access to Qwen, DeepSeek, OpenAI, and other cutting-edge models
  • Smart Query Generation: Natural language to SQL conversion
  • Query Optimization: AI suggests performance improvements and best practices
  • Learning Assistant: Perfect for SQL learners and data professionals

πŸ“ Universal Data Import

  • File Formats: CSV, JSON, XLSX, Parquet support
  • Direct Loading: HTTPS URLs and S3 bucket integration
  • Auto-Detection: Smart schema inference and data type detection

πŸ“Š Advanced Analytics & Visualization

  • Interactive Charts: Built-in Chart.js integration for stunning visualizations
  • Export Options: CSV, JSON, XLSX, and Parquet export formats

πŸ”’ Privacy-First Architecture

  • Client-Side Processing: All data operations happen in your browser
  • Zero Data Transmission: Raw data never sent to external servers
  • Secure AI: API keys protected on server-side, only results shared
  • Local Storage: Complete control over your sensitive datasets

🎯 Perfect For

πŸ‘¨β€πŸŽ“ SQL Learners & Students

  • No Setup Required: Skip complex database installations and cloud configurations
  • Interactive Learning: Practice SQL with real datasets instantly
  • AI Tutoring: Get explanations and suggestions for your queries
  • Safe Environment: Experiment without breaking production systems

πŸ‘¨β€πŸ’Ό Professionals & Analysts

  • Rapid Prototyping: Test hypotheses and explore data without infrastructure delays
  • Data Wrangling: Clean, transform, and analyze datasets with powerful SQL
  • Offline Capability: Work with sensitive data without cloud dependencies

πŸ› οΈ Technology Stack

Frontend & UI

  • Next.js 15: React framework with App Router for optimal performance
  • TypeScript: Type-safe development with enhanced developer experience
  • Tailwind CSS: Utility-first CSS framework for rapid UI development
  • Radix UI: Accessible, unstyled UI components for professional interfaces

Data & Analytics

  • DuckDB-WASM: High-performance analytical database in WebAssembly
  • Chart.js: Powerful charting library for data visualization
  • XLSX.js: Excel file processing and generation

AI

  • OpenRouter: Unified API access to leading AI models
  • Model Support: Qwen, DeepSeek, OpenAI GPT, and other cutting-edge free models

πŸš€ Quick Start

Live Demo

Try Duckbase instantly at duckbase.studio - no installation required!

Local Development

Prerequisites

  • Node.js 18+ (Latest LTS recommended)
  • npm or yarn package manager
  • OpenRouter API Key (Free tier available)

Installation

  1. Clone the repository:

    git clone https://github.com/Saadain23/duckbase.git
    cd duckbase
  2. Install dependencies:

    npm install
  3. Start development server:

    npm run dev
  4. Open your browser: Navigate to http://localhost:3000

πŸ“– How to Use Duckbase

1. Import Your Data

  • Upload Data: Simply upload CSV, JSON, XLSX, or Parquet files into the browser
  • URL Import: Load data directly from HTTPS URLs or S3 buckets
  • Auto-Detection: Smart schema inference and data type detection
  • Instant Loading: Data is processed and ready for analysis in seconds

2. AI-Powered Analysis

  • Natural Language: Ask questions like "I want to know sales trends by region"
  • Smart SQL: AI generates optimized queries automatically
  • Query Explanation: Get detailed explanations of generated SQL
  • Learning Mode: Perfect for SQL beginners and professionals

3. Advanced Analytics

  • Custom Queries: Write complex SQL
  • Real-time Results: Execute queries and see results instantly
  • Interactive Charts: Visualize data with built-in Chart.js integration
  • Export Options: Download results in CSV, JSON, XLSX, or Parquet formats

🀝 Contributing

We welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help makes Duckbase better for everyone.

How to Contribute

  1. Fork the repository and clone it locally
  2. Create a feature branch from the dev branch
  3. Make your changes following our coding standards
  4. Test thoroughly to ensure everything works
  5. Submit a pull request to the dev branch

Development Guidelines

  • Follow TypeScript best practices
  • Use conventional commit messages
  • Add tests for new functionality
  • Update documentation as needed
  • Ensure all linting passes

For detailed contribution guidelines, see our CONTRIBUTING.md file.

Community

  • Issues: Report bugs and request features on GitHub Issues
  • Discussions: Join community discussions and ask questions
  • Star: Show your support by starring the repository

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


Built with ❀️ by Saadain

Website β€’ GitHub β€’ Issues β€’ Contributing

About

In-browser data warehouse powered by DuckDB-WASM. SQL analytics without servers - your data never leaves the browser.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published