🚧 This project is under active development and not yet suitable for production use. Expect breaking changes, incomplete features, and evolving APIs.

Qwery is the most capable platform for querying and visualizing data without requiring any prior technical knowledge in data engineering. Using natural language in any supported language, Qwery seamlessly integrates with hundreds of datasources, automatically generates optimized queries, and delivers outcomes across multiple targets including result sets, dashboards, data apps, reports, and APIs.

1. Choose your environment: Download the desktop application or connect to the Qwery Cloud Platform
2. Connect your data: Link to your databases, APIs, or other datasources
3. Start querying: Use natural language to query your datasources instantly
4. Work with AI agents: Press CMD/CTRL + L to collaborate with intelligent agents that assist with your data workflows

• Natural Language Querying: Ask questions in plain language, get SQL automatically
• Multi-Database Support: PostgreSQL, MySQL, MongoDB, DuckDB, ClickHouse, SQL Server, and more
• AI-Powered Agents: Intelligent assistants that help with data workflows (CMD/CTRL + L)
• Visual Data Apps: Build dashboards and data applications without code
• Desktop & Cloud: Run locally or use our cloud platform
• Template Library: Pre-built notebooks, queries, and dashboards
• Extensible: Plugin system for custom datasources and integrations

• Node.js >= 22.x
• pnpm >= 10.x

# Clone the repository
git clone https://github.com/Guepard-Corp/qwery-core.git
cd qwery-core

# Install dependencies
pnpm install

# Start development server
pnpm dev

The web app will be available at http://localhost:3000

# Build and run desktop app
pnpm desktop:dev

This is a Turborepo monorepo with the following structure:

• apps/web - Main React Router SaaS application
• apps/cli - Command-line interface
• apps/desktop - Desktop application (Electron)
• apps/e2e - Playwright end-to-end tests
• packages/features/* - Feature packages
• packages/ - Shared packages and utilities
• tooling/ - Build tools and development scripts

# Start all apps in development mode
pnpm dev

# Start specific app
pnpm --filter web dev        # Web app (port 3000)
pnpm --filter desktop dev    # Desktop app

# Code Quality
pnpm format:fix              # Auto-fix formatting
pnpm lint:fix                # Auto-fix linting issues
pnpm typecheck               # Type checking
pnpm check                   # Run all quality checks (format, lint, typecheck, build, test)

# Build
pnpm build                   # Build all packages

# Testing
pnpm test                    # Run all tests

• TypeScript: Strict type checking, avoid any types
• Linting: ESLint with strict rules
• Formatting: Prettier with consistent style
• Testing: Vitest for unit tests, Playwright for E2E

Always run pnpm check before committing to ensure all quality checks pass.

• Contributing Guide
• Pull Request Guide
• Desktop App Documentation
• RFCs

We welcome contributions! Check out our Contributing Guide to get started.

1. Run pnpm check to ensure all quality checks pass
2. Make sure your code follows our TypeScript guidelines
3. Write tests for new features
4. Update documentation as needed

• Review good first issues
• Read our Code of Conduct
• Check AGENTS.md for development guidelines
• Join our Discord community

• Discord: Join our Discord for discussions and support
• GitHub Issues: Report bugs and request features
• YouTube: Watch demos and tutorials

This project uses the Elastic License 2.0 (ELv2). See the LICENSE file for details.

We're grateful to the open source community. See our Thank You page for acknowledgments.