From b7bdbefe8b2c2527e192ed8b6c4afd3a977876fd Mon Sep 17 00:00:00 2001
From: gigagrug <55370306+gigagrug@users.noreply.github.com>
Date: Thu, 13 Nov 2025 20:19:50 -0500
Subject: [PATCH] Create README.md for Turso Database Python bindings
Added README.md for Turso Database Python bindings with installation instructions, features, and usage examples.
---
bindings/python/README.md | 68 +++++++++++++++++++++++++++++++++++++++
1 file changed, 68 insertions(+)
create mode 100644 bindings/python/README.md
diff --git a/bindings/python/README.md b/bindings/python/README.md
new file mode 100644
index 000000000..ad94e59bd
--- /dev/null
+++ b/bindings/python/README.md
@@ -0,0 +1,68 @@
+
+
Turso Database for Python
+
+
+
+ 
+ 
+
+
+ 
+
+
+---
+
+## About
+
+> **⚠️ Warning:** This software is in BETA. It may still contain bugs and unexpected behavior. Use caution with production data and ensure you have backups.
+
+## Features
+
+- **SQLite compatible:** SQLite query language and file format support ([status](https://github.com/tursodatabase/turso/blob/main/COMPAT.md)).
+- **In-process**: No network overhead, runs directly in your Python process
+- **Cross-platform**: Supports Linux, macOS, Windows
+
+## Installation
+```bash
+uv pip install pyturso
+```
+
+## Getting Started
+```python
+import turso
+
+# Create/open a database
+# con = turso.connect(":memory:") # For memory mode
+con = turso.connect("sqlite.db")
+cur = con.cursor()
+
+# Create a table
+cur.execute("""
+ CREATE TABLE IF NOT EXISTS users (
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
+ username TEXT NOT NULL
+ )
+""")
+con.commit()
+
+# Insert data
+cur.execute("INSERT INTO users (username) VALUES (?)", ("alice",))
+cur.execute("INSERT INTO users (username) VALUES (?)", ("bob",))
+con.commit()
+
+# Query data
+res = cur.execute("SELECT * FROM users")
+users = res.fetchall()
+print(users)
+# Output: [(1, 'alice'), (2, 'bob')]
+```
+
+## License
+
+This project is licensed under the [MIT license](../../LICENSE.md).
+
+## Support
+
+- [GitHub Issues](https://github.com/tursodatabase/turso/issues)
+- [Documentation](https://docs.turso.tech)
+- [Discord Community](https://tur.so/discord)