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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1fdc90d0086741ba06e87e11d6dd76bafa9e31fc9b62174088a152c9e251b5b6
|
|
| MD5 |
67684998262f27079baebf530a912e4c
|
|
| BLAKE2b-256 |
71416fc9256c22008e3362f20099f56fabed1e08bbe287aedc624fb66c1c2053
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
589785447848e8e4eb89e3ad40a1284d4e3d57902c0c3a5c1e0d2f3fbb6d6ce7
|
|
| MD5 |
46b2e56ff82e70f21a78b8f0015e08ed
|
|
| BLAKE2b-256 |
4b3cb0462687d1c0f681d26e02aee116dee5e8fbda415ede1fd4fb629d95799f
|