Getting Started
This guide will help you set up an5 in your project in under 5 minutes for Rust with Sqlite.
For the current implementation and package maturity overview, see Feature Status.
Prerequisites
- Node.js 18+ (Node 24 recommended for schema compiler and CLI)
-
Rust 1.75+ (Cargo)
- Connection to Sqlite (or local embedded setup)
Installation
# In Cargo.toml
[dependencies]
tokio = { version = "1", features = ["full"] }
serde = { version = "1", features = ["derive"] }
serde_json = "1"
chrono = { version = "0.4", features = ["serde"] }
Generate Rust client modules with npm run generate.
Configuration
1. Set up Environment Variables
Edit .env and configure your database connection string:
DATABASE_URL=sqlite://./dev.db
2. Define Your Schema
Create .an5 files in the an5Schema/ directory:
// an5Schema/User.an5
model User {
id NVARCHAR(1000) @id @default(uuid())
email NVARCHAR(255) @unique
name NVARCHAR(255)?
createdAt DATETIME2 @default(now())
@@map("users")
}
3. Generate Client Code
Run from the an5Orm/ repository directory:
npm run generate
This generates type-safe client code in an5Client/rust/.
4. Push Schema to Database
npm run db:push
This creates the tables in your database.
Your First Query
use an5_client::{An5Client, UserCreateInput, UserFindManyArgs};
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let db = An5Client::from_env().await?;
// Create a user
let user = db.user().create(UserCreateInput {
email: "john@example.com".to_string(),
name: Some("John Doe".to_string()),
}).await?;
println!("Created user: {:?}", user);
// Find all users
let users = db.user().find_many(UserFindManyArgs::default()).await?;
println!("Found {} users", users.len());
Ok(())
}
Project Structure
an5/
├── an5Schema/ # Schema definitions (.an5 files)
├── an5Client/ # Generated client code for all target languages
│ ├── typescript/
│ ├── python/
│ ├── dotnet/
│ ├── golang/
│ ├── rust/
│ ├── java/
│ ├── kotlin/
│ └── swift/
├── an5Orm.config.js # ORM configuration & database mapping
└── .env # Environment variables & connection strings
Available Commands
Schema/database commands run from the an5Orm/ repository directory:
| Command | Where | Description |
|---|---|---|
npm run generate |
an5Orm/ |
Generate client code from schema |
npm run db:push |
an5Orm/ |
Push schema to database |
npm run db:pull |
an5Orm/ |
Pull schema from database |
npm run db:seed |
an5Orm/ |
Seed database with sample data |
npm run db:migrate diff |
an5Orm/ |
Compare schema with database |
npm run db:migrate:generate |
an5Orm/ |
Generate migration SQL |
npm run db:migrate:apply |
an5Orm/ |
Apply pending migration files |
npm run db:migrate:rollback |
an5Orm/ |
Roll back migrations |
npm run db:migrate:status |
an5Orm/ |
Show migration status |
Next Steps
- Database Providers - Comprehensive guide for all 6 database providers
- Client Languages - Multi-language client generation reference
- CRUD Operations - Create, read, update, and delete data
- Schema Definition - Learn how to define your data models