docs: Add a readme (#8)

README.md

@@ -1 +1,27 @@
 # advanced_alchemy
+
+A carefully crafted, thoroughly tested, optimized companion library for SQLAlchemy,
+offering features such as:
+
+- Sync and async repositories, featuring common CRUD and highly optimized bulk operations
+- Integration with major web frameworks (Starlette, FastAPI, Sanic, ...)
+- Custom-built alembic configuration and CLI with optional framework integration
+- Utility base classes with audit columns, primary keys and utility functions
+- Optimized JSON types
+
+* Pre-configured base classes with audit columns UUID or Big Integer primary keys and
+  a  [sentinel column](https://docs.sqlalchemy.org/en/20/core/connections.html#configuring-sentinel-columns>).
+* Synchronous and asynchronous repositories featuring:
+  * Common CRUD operations for SQLAlchemy models
+  * Bulk inserts, updates, upserts, and deletes with dialect-specific enhancements
+  * [lambda_stmt](https://docs.sqlalchemy.org/en/20/core/sqlelement.html#sqlalchemy.sql.expression.lambda_stmt) when possible
+    for improved query building performance
+  * Integrated counts, pagination, sorting, filtering with ``LIKE``, ``IN``, and dates before and/or after.
+* Tested support for multiple database backends including:
+
+  - SQLite via [aiosqlite](https://aiosqlite.omnilib.dev/en/stable/) or [sqlite](https://docs.python.org/3/library/sqlite3.html)
+  - Postgres via [asyncpg](https://magicstack.github.io/asyncpg/current/)_ or [psycopg3 (async or sync)](https://www.psycopg.org/psycopg3/)
+  - MySQL via [asyncmy](https://github.com/long2ice/asyncmy)
+  - Oracle via [oracledb](https://oracle.github.io/python-oracledb/)
+  - Google Spanner via [spanner-sqlalchemy](https://github.com/googleapis/python-spanner-sqlalchemy/)
+  - DuckDB via [duckdb_engine](https://github.com/Mause/duckdb_engine>)