Skip to content

Installation

Requirements

  • Python 3.10 or higher
  • One of the supported ORMs: SQLAlchemy, Tortoise, Peewee, Django, or SQLModel

Installing OrmAI

Basic Installation

pip install ormai

With ORM-Specific Extras

Install with extras for your preferred ORM:

pip install ormai[sqlalchemy]
pip install ormai[tortoise]
pip install ormai[peewee]
pip install ormai[django]
pip install ormai[all]

If you're using uv as your package manager:

uv add ormai
uv add ormai --extra sqlalchemy

Development Installation

For development or contributing:

git clone https://github.com/neul-labs/ormai.git
cd ormai
uv sync --all-extras

Optional Dependencies

MCP Server Support

For Model Context Protocol server integration:

pip install ormai[mcp]

FastAPI Integration

For FastAPI integration:

pip install ormai[fastapi]

Full Installation

Install all optional dependencies:

pip install ormai[all]

Verifying Installation

Verify your installation by importing OrmAI:

import ormai
print(ormai.__version__)

Or check the available quickstart functions:

from ormai.quickstart import mount_sqlalchemy, mount_tortoise, mount_peewee
print("OrmAI installed successfully!")

TypeScript Edition

For TypeScript/Node.js projects, see the TypeScript Edition documentation.

npm install ormai
# or
yarn add ormai