Skip to main content

AI-Native Database Agent for Safe & Autonomous Operations — Text-to-SQL with safety guardrails

Project description

🦞 QueryClaw

The AI-Native Database Agent for Safe & Autonomous Operations.

🚀 Mission: To bridge the gap between Natural Language and Transactional Database Operations with enterprise-grade safety.

QueryClaw is not just a Text-to-SQL chatbot. It is an intelligent agent that plans, validates, executes, and self-corrects database operations (CRUD + DDL) with built-in safety guardrails, transaction management, and audit trails.

✨ Key Features

  • 🛡️ Safety First: AST-based static analysis, execution plan dry-runs, and auto-rollback mechanisms.
  • 🧠 Multi-Agent Planning: Decomposes complex natural language tasks into atomic, transactional SQL steps.
  • 🔗 Business Context Aware: RAG-powered understanding of schema, foreign keys, and business metrics.
  • 🔄 Self-Healing: Automatically detects errors, rewrites SQL, and retries.
  • 📜 Full Audit: Complete lineage from natural language prompt to before/after data snapshots.

🏗 Architecture

  • Core: Python
  • Protocol: Model Context Protocol (MCP) Ready
  • Support: MySQL, PostgreSQL, SQLite (More coming soon)

🚀 Roadmap

  • Phase 1: MVP - Safe Read-Only Queries & Schema RAG
  • Phase 2: Write Operations with Dry-Run & Rollback
  • Phase 3: Multi-Agent Planning & Human-in-the-Loop
  • Phase 4: MCP Server & Ecosystem Integrations

🤝 Contributing

We welcome contributions! Please read our Contributing Guidelines before submitting PRs.

📄 License

Distributed under the Apache 2.0 License. See LICENSE for more information.


Made with ❤️ by the QueryClaw Team

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

queryclaw-0.1.0.tar.gz (6.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

queryclaw-0.1.0-py3-none-any.whl (6.6 kB view details)

Uploaded Python 3

File details

Details for the file queryclaw-0.1.0.tar.gz.

File metadata

  • Download URL: queryclaw-0.1.0.tar.gz
  • Upload date:
  • Size: 6.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for queryclaw-0.1.0.tar.gz
Algorithm Hash digest
SHA256 1fdc90d0086741ba06e87e11d6dd76bafa9e31fc9b62174088a152c9e251b5b6
MD5 67684998262f27079baebf530a912e4c
BLAKE2b-256 71416fc9256c22008e3362f20099f56fabed1e08bbe287aedc624fb66c1c2053

See more details on using hashes here.

File details

Details for the file queryclaw-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: queryclaw-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 6.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for queryclaw-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 589785447848e8e4eb89e3ad40a1284d4e3d57902c0c3a5c1e0d2f3fbb6d6ce7
MD5 46b2e56ff82e70f21a78b8f0015e08ed
BLAKE2b-256 4b3cb0462687d1c0f681d26e02aee116dee5e8fbda415ede1fd4fb629d95799f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page