{"id":34080074,"url":"https://github.com/mr-fatalyst/oxyde","last_synced_at":"2026-03-13T11:04:43.070Z","repository":{"id":327114959,"uuid":"1089078092","full_name":"mr-fatalyst/oxyde","owner":"mr-fatalyst","description":"Oxyde ORM is a type-safe, Pydantic-centric asynchronous ORM with a high-performance Rust core designed for clarity, speed, and reliability.","archived":false,"fork":false,"pushed_at":"2026-03-10T20:44:59.000Z","size":5274,"stargazers_count":143,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-10T23:02:56.580Z","etag":null,"topics":["async","asyncio","database","fastapi","mysql","orm","postgresql","pydantic","sqlite","sqlx"],"latest_commit_sha":null,"homepage":"https://oxyde.fatalyst.dev/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mr-fatalyst.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-03T21:20:02.000Z","updated_at":"2026-03-10T20:44:24.000Z","dependencies_parsed_at":"2025-12-05T08:00:47.228Z","dependency_job_id":null,"html_url":"https://github.com/mr-fatalyst/oxyde","commit_stats":null,"previous_names":["mr-fatalyst/oxyde"],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/mr-fatalyst/oxyde","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-fatalyst%2Foxyde","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-fatalyst%2Foxyde/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-fatalyst%2Foxyde/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-fatalyst%2Foxyde/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mr-fatalyst","download_url":"https://codeload.github.com/mr-fatalyst/oxyde/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-fatalyst%2Foxyde/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30466311,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-13T11:00:43.441Z","status":"ssl_error","status_checked_at":"2026-03-13T11:00:23.173Z","response_time":60,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["async","asyncio","database","fastapi","mysql","orm","postgresql","pydantic","sqlite","sqlx"],"created_at":"2025-12-14T11:42:21.842Z","updated_at":"2026-03-13T11:04:43.051Z","avatar_url":"https://github.com/mr-fatalyst.png","language":"Python","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/mr-fatalyst/oxyde/master/logo.png\" alt=\"Logo\" width=\"200\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e \u003cb\u003eOxyde ORM\u003c/b\u003e is a type-safe, Pydantic-centric asynchronous ORM with a high-performance Rust core designed for clarity, speed, and reliability. \u003c/p\u003e\n\n\u003cp align=\"center\"\u003e Inspired by the elegance of \u003ca href=\"https://www.djangoproject.com/\"\u003eDjango's ORM\u003c/a\u003e, Oxyde focuses on explicitness over magic, providing a modern developer-friendly workflow with predictable behavior and strong typing throughout. \u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/license/mr-fatalyst/oxyde\"\u003e\n  \u003cimg src=\"https://github.com/mr-fatalyst/oxyde/actions/workflows/test.yml/badge.svg\"\u003e\n  \u003cimg src=\"https://img.shields.io/pypi/v/oxyde\"\u003e\n  \u003cimg src=\"https://img.shields.io/pypi/pyversions/oxyde\"\u003e\n  \u003cimg src=\"https://static.pepy.tech/badge/oxyde\" alt=\"PyPI Downloads\"\u003e\n\u003c/p\u003e\n\n---\n\n\u003e **Heads up!** Oxyde is a young project under active development. The API may evolve between minor versions. Feedback, bug reports, and ideas are very welcome. Feel free to [open an issue](https://github.com/mr-fatalyst/oxyde/issues)!\n\n## Features\n\n- **Django-style API** — Familiar `Model.objects.filter()` syntax\n- **Pydantic v2 models** — Full validation, type hints, serialization\n- **Async-first** — Built for modern async Python with `asyncio`\n- **Rust performance** — SQL generation and execution in native Rust\n- **Multi-database** — PostgreSQL, SQLite, MySQL support\n- **Transactions** — `transaction.atomic()` context manager with savepoints\n- **Migrations** — Django-style `makemigrations` and `migrate` CLI\n\n## Performance\n\nBenchmarks vs popular Python ORMs (avg ops/sec, higher is better):\n\n| Database   | Oxyde | Tortoise | Piccolo | Django | SQLAlchemy | SQLModel | Peewee |\n|------------|-------|----------|---------|--------|------------|----------|--------|\n| PostgreSQL | 1,475 | 888      | 932     | 736    | 445        | 431      | 80     |\n| MySQL      | 1,239 | 794      | —       | 714    | 536        | 505      | 461    |\n| SQLite     | 2,525 | 1,882    | 469     | 1,294  | 588        | 567      | 548    |\n\nFull benchmark report: **[Documentation](https://oxyde.fatalyst.dev/latest/advanced/benchmarks/)**\n\n## Installation\n\n```bash\npip install oxyde\n```\n\n## Quick Start\n\n### 1. Initialize Project\n\n```bash\noxyde init\n```\n\nThis creates `oxyde_config.py` with your database settings and model paths.\n\n### 2. Define Models\n\n```python\n# models.py\nfrom oxyde import Model, Field\n\nclass User(Model):\n    id: int | None = Field(default=None, db_pk=True)\n    name: str\n    email: str = Field(db_unique=True)\n    age: int | None = Field(default=None)\n\n    class Meta:\n        is_table = True\n```\n\n### 3. Create Tables\n\n```bash\noxyde makemigrations\noxyde migrate\n```\n\n### 4. Use It\n\n```python\nimport asyncio\nfrom oxyde import db\nfrom models import User\n\nasync def main():\n    await db.init(default=\"sqlite:///app.db\")\n\n    # Create\n    user = await User.objects.create(name=\"Alice\", email=\"alice@example.com\", age=30)\n\n    # Read\n    users = await User.objects.filter(age__gte=18).all()\n    user = await User.objects.get(id=1)\n\n    # Update\n    user.age = 31\n    await user.save()\n\n    # Delete\n    await user.delete()\n\n    await db.close()\n\nasyncio.run(main())\n```\n\n## Transactions\n\n```python\nfrom oxyde.db import transaction\n\nasync with transaction.atomic():\n    user = await User.objects.create(name=\"Alice\", email=\"alice@example.com\")\n    await Profile.objects.create(user_id=user.id)\n    # Auto-commits on success, rolls back on exception\n```\n\n## FastAPI Integration\n\n```python\nfrom fastapi import FastAPI\nfrom oxyde import db\n\napp = FastAPI(\n    lifespan=db.lifespan(\n        default=\"postgresql://localhost/mydb\",\n    )\n)\n\n@app.get(\"/users\")\nasync def get_users():\n    return await User.objects.filter(is_active=True).all()\n```\n\n## Database Support\n\n| Database   | Min Version | Status | Notes |\n|------------|-------------|--------|-------|\n| PostgreSQL | 12+ | Full | RETURNING, UPSERT, FOR UPDATE/SHARE, JSON, Arrays |\n| SQLite     | 3.35+ | Full | RETURNING, UPSERT, WAL mode by default |\n| MySQL      | 8.0+ | Full | UPSERT via ON DUPLICATE KEY, FOR UPDATE/SHARE |\n\n**Connection URLs:**\n\n```\npostgresql://user:password@localhost:5432/database\nsqlite:///path/to/database.db\nsqlite:///:memory:\nmysql://user:password@localhost:3306/database\n```\n\n## Ecosystem\n\n### Oxyde Admin\n\nAuto-generated admin panel for Oxyde ORM with zero boilerplate.\n\n- Automatic CRUD, search, filters, export\n- FastAPI, Litestar, Sanic, Quart, Falcon\n- Theming, authentication, bulk operations\n\n```bash\npip install oxyde-admin\n```\n\n[GitHub →](https://github.com/mr-fatalyst/oxyde-admin)\n\n## Documentation\n\nFull documentation: **[https://oxyde.fatalyst.dev/](https://oxyde.fatalyst.dev/)**\n\n- [Quick Start](https://oxyde.fatalyst.dev/latest/getting-started/quickstart/) — Get up and running\n- [User Guide](https://oxyde.fatalyst.dev/latest/guide/models/) — Models, queries, relations, transactions\n- [Cheatsheet](https://oxyde.fatalyst.dev/latest/cheatsheet/) — Quick reference for all methods\n\n## Contributing\n\nIf you have suggestions or find a bug, please open an issue or create a pull request on GitHub.\n\n## License\n\nThis project is licensed under the terms of the MIT license.\n","funding_links":[],"categories":["Utilities"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmr-fatalyst%2Foxyde","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmr-fatalyst%2Foxyde","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmr-fatalyst%2Foxyde/lists"}