Skip to content

Commit 2c405c8

Browse files
Update README.md
1 parent a1f3250 commit 2c405c8

1 file changed

Lines changed: 37 additions & 146 deletions

File tree

README.md

Lines changed: 37 additions & 146 deletions
Original file line numberDiff line numberDiff line change
@@ -1,168 +1,63 @@
1-
🚀 Ormax ORM — Fastest Async ORM for Python
2-
3-
4-
5-
> Ormax ORM — The fastest, most secure, and feature-rich asynchronous ORM for Python.
6-
Optimized for high-performance database access in modern web apps, APIs, and microservices.
7-
Supports MariaDB, MySQL, PostgreSQL, SQLite3, Microsoft SQL Server, Oracle Database, Amazon Aurora.
8-
9-
10-
11-
12-
---
13-
14-
🌟 Why Ormax ORM?
15-
16-
🚀 Fastest ORM in Python — Benchmark-proven speed beating other popular ORMs.
17-
18-
🔌 Multi-Database Support — MariaDB, MySQL, PostgreSQL, SQLite3, MSSQL, Oracle, Aurora.
19-
20-
⚡ Fully Async — Built with asyncio for extreme performance.
21-
22-
🛡️ Secure by Design — Protection against SQL injection & strong input validation.
23-
24-
📦 Easy to Use — Simple syntax inspired by Django ORM, but fully async.
25-
26-
🔗 Relationship Support — ForeignKey, reverse relations, and advanced querying.
27-
28-
💾 Connection Pooling — Optimized database connection management.
29-
30-
💡 Advanced QuerySet — select_related, prefetch_related, chaining filters, pagination.
31-
32-
📊 Bulk Operations — Create, update, delete multiple rows efficiently.
33-
34-
🔄 Transaction Support — ACID-compliant transactions.
1+
# 🚀 Ormax ORM — Fastest Async ORM for Python
352

3+
[![Python Version](https://img.shields.io/badge/python-3.7%2B-blue)](https://www.python.org/downloads/)
4+
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
5+
[![Async](https://img.shields.io/badge/async-await-brightgreen)](https://docs.python.org/3/library/asyncio.html)
366

7+
> **Ormax ORM** — The **fastest**, most secure, and feature-rich **asynchronous ORM** for Python.
8+
> Optimized for **high-performance** database access in modern web apps, APIs, and microservices.
9+
> Supports **MariaDB, MySQL, PostgreSQL, SQLite3, Microsoft SQL Server, Oracle Database, Amazon Aurora**.
3710
3811
---
3912

40-
📈 Benchmark — Fastest Python ORM
41-
42-
According to independent benchmarks, Ormax ORM is up to 2× faster than traditional ORMs like SQLAlchemy and Tortoise ORM when performing async CRUD operations.
43-
44-
ORM Insert 10k rows Select 10k rows Update 10k rows
45-
46-
Ormax ORM 0.82s 0.65s 0.78s
47-
Tortoise ORM 1.45s 1.10s 1.50s
48-
SQLAlchemy 1.60s 1.25s 1.62s
49-
50-
51-
> See full benchmark results in our documentation.
52-
53-
13+
## 🌟 Why Ormax ORM?
5414

55-
56-
---
57-
58-
📦 Installation
59-
60-
pip install ormax
61-
62-
Or install from source:
63-
64-
git clone https://github.com/shayanheidari01/ormax.git
65-
cd ormax
66-
pip install -e .
67-
68-
69-
---
70-
71-
🛠️ Dependencies
72-
73-
# For MySQL/MariaDB
74-
pip install aiomysql
75-
76-
# For PostgreSQL
77-
pip install asyncpg
78-
79-
# For SQLite
80-
pip install aiosqlite
81-
82-
# For Microsoft SQL Server
83-
pip install aioodbc
84-
85-
# For Oracle Database
86-
pip install async-oracledb
87-
88-
89-
---
90-
91-
🚀 Quick Start
92-
93-
from ormax import Database, Model
94-
from ormax.fields import *
95-
96-
class Author(Model):
97-
id = AutoField()
98-
name = CharField(max_length=100)
99-
100-
class Book(Model):
101-
id = AutoField()
102-
title = CharField(max_length=200)
103-
author = ForeignKeyField('Author', related_name='books')
104-
105-
db = Database("sqlite:///example.db")
106-
await db.connect()
107-
db.register_model(Author, Book)
108-
await db.create_tables()
109-
110-
author = await Author.create(name="J.K. Rowling")
111-
book = await Book.create(title="Harry Potter", author=author)
112-
113-
114-
---
115-
116-
🔍 SEO Keywords
117-
118-
Fastest Python ORM, Async Python ORM, Best Python ORM 2025, High Performance ORM,
119-
Python asyncio ORM, PostgreSQL Async ORM, MySQL Async ORM, Secure Python ORM.
120-
121-
122-
---
123-
124-
Made with ❤️ for Python developers who value speed and simplicity.
125-
126-
- **🔌 Multi-Database Support** — MariaDB, MySQL, PostgreSQL, SQLite3, MSSQL, Oracle, Aurora.
127-
- **⚡ Fully Async** — Built with `asyncio` for extreme performance.
128-
- **🛡️ Secure by Design** — Protection against SQL injection & strong input validation.
129-
- **📦 Easy to Use** — Simple syntax inspired by Django ORM, but fully async.
130-
- **🔗 Relationship Support** — ForeignKey, reverse relations, and advanced querying.
131-
- **💾 Connection Pooling** — Optimized database connection management.
132-
- **💡 Advanced QuerySet**`select_related`, `prefetch_related`, chaining filters, pagination.
133-
- **📊 Bulk Operations** — Create, update, delete multiple rows efficiently.
134-
- **🔄 Transaction Support** — ACID-compliant transactions.
15+
* **🚀 Fastest ORM in Python** — Benchmark-proven speed beating other popular ORMs.
16+
* **🔌 Multi-Database Support** — MariaDB, MySQL, PostgreSQL, SQLite3, MSSQL, Oracle, Aurora.
17+
* **⚡ Fully Async** — Built with `asyncio` for extreme performance.
18+
* **🛡️ Secure by Design** — Protection against SQL injection & strong input validation.
19+
* **📦 Easy to Use** — Simple syntax inspired by Django ORM, but fully async.
20+
* **🔗 Relationship Support** — ForeignKey, reverse relations, and advanced querying.
21+
* **💾 Connection Pooling** — Optimized database connection management.
22+
* **💡 Advanced QuerySet**`select_related`, `prefetch_related`, chaining filters, pagination.
23+
* **📊 Bulk Operations** — Create, update, delete multiple rows efficiently.
24+
* **🔄 Transaction Support** — ACID-compliant transactions.
13525

13626
---
13727

13828
## 📈 Benchmark — Fastest Python ORM
29+
13930
According to independent benchmarks, **Ormax ORM** is **up to 2× faster** than traditional ORMs like SQLAlchemy and Tortoise ORM when performing async CRUD operations.
14031

14132
| ORM | Insert 10k rows | Select 10k rows | Update 10k rows |
142-
|---------------|----------------|----------------|----------------|
143-
| **Ormax ORM** | **0.82s** | **0.65s** | **0.78s** |
144-
| Tortoise ORM | 1.45s | 1.10s | 1.50s |
145-
| SQLAlchemy | 1.60s | 1.25s | 1.62s |
33+
| ------------- | --------------- | --------------- | --------------- |
34+
| **Ormax ORM** | **0.82s** | **0.65s** | **0.78s** |
35+
| Tortoise ORM | 1.45s | 1.10s | 1.50s |
36+
| SQLAlchemy | 1.60s | 1.25s | 1.62s |
14637

14738
> See full benchmark results in our [documentation](docs/benchmark.md).
14839
14940
---
15041

15142
## 📦 Installation
43+
15244
```bash
15345
pip install ormax
46+
```
15447

15548
Or install from source:
15649

50+
```bash
15751
git clone https://github.com/shayanheidari01/ormax.git
15852
cd ormax
15953
pip install -e .
160-
54+
```
16155

16256
---
16357

164-
🛠️ Dependencies
58+
## 🛠️ Dependencies
16559

60+
```bash
16661
# For MySQL/MariaDB
16762
pip install aiomysql
16863

@@ -177,12 +72,13 @@ pip install aioodbc
17772

17873
# For Oracle Database
17974
pip install async-oracledb
180-
75+
```
18176

18277
---
18378

184-
🚀 Quick Start
79+
## 🚀 Quick Start
18580

81+
```python
18682
from ormax import Database, Model
18783
from ormax.fields import *
18884

@@ -202,20 +98,15 @@ await db.create_tables()
20298

20399
author = await Author.create(name="J.K. Rowling")
204100
book = await Book.create(title="Harry Potter", author=author)
205-
101+
```
206102

207103
---
208104

209-
🔍 SEO Keywords
210-
211-
Fastest Python ORM, Async Python ORM, Best Python ORM 2025, High Performance ORM,
212-
Python asyncio ORM, PostgreSQL Async ORM, MySQL Async ORM, Secure Python ORM.
105+
## 🔍 SEO Keywords
213106

107+
`Fastest Python ORM`, `Async Python ORM`, `Best Python ORM 2025`, `High Performance ORM`,
108+
`Python asyncio ORM`, `PostgreSQL Async ORM`, `MySQL Async ORM`, `Secure Python ORM`.
214109

215110
---
216111

217-
Made with ❤️ for Python developers who value speed and simplicity.
218-
219-
220-
221-
112+
**Made with ❤️ for Python developers who value speed and simplicity.**

0 commit comments

Comments
 (0)