benavlabs/fastcrud

FastAPI용 강력한 비동기 CRUD 작업과 자동 엔드포인트 생성 라이브러리

개발 재료맘대로 써도 됨 · MIT백엔드·DBPython난이도

1,537+7이번 주0 찜

116포크12이슈

중간맛 분석

Python 3.10+, FastAPI, SQLAlchemy 2.0, Pydantic 2.4.1 필요합니다. 비동기 CRUD 메서드, 자동 조인 감지, 동적 정렬, 오프셋/커서 기반 페이지네이션을 지원하며 즉시 사용 가능한 엔드포인트를 생성합니다. crud_router로 자동 생성하거나 FastCRUD를 커스텀 엔드포인트에 직접 사용할 수 있어요. N+1 쿼리 방지와 집계/CTE 같은 복잡한 작업은 원본 SQLAlchemy로 처리하는 방식을 권장합니다.

이런 레포예요

이럴 때 쓰면 좋아요

FastAPI REST API의 표준 CRUD 엔드포인트를 빠르게 구축하고 싶을 때
대규모 데이터셋을 커서 기반 페이지네이션으로 효율적으로 처리해야 할 때
여러 테이블 간 조인이 필요한 복잡한 쿼리를 동적으로 구성해야 할 때

핵심 기능

완전 비동기 CRUD 메서드 (create, read, update, delete, exists, count)자동 조인 조건 감지 및 관계 테이블 조회오프셋·커서 기반 페이지네이션과 동적 필터링/정렬

대안 대비 차별점

SQLAlchemy 2.0 기반으로 최신 표준을 따르며, 자동 조인 감지, 커서 기반 페이지네이션, AI 코딩 에이전트 지원(Library Skill)을 제공해 기존 미유지 프로젝트들보다 현대적이고 확장성 높습니다.

먹어본 사람들

실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.

시식평 · 먹어본 사람 한마디

아직 시식평이 없어요. 먹어보셨다면 첫 한마디를 남겨주세요.

다른 레포 시식평 구경하기 →

이 레포로 만든 것들

🖋 완주 인증하기

아직 이 레포로 만든 완주 인증이 없어요. 첫 밥도장을 찍어보세요!

이 레포, 해먹는 법

처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.

준비물

Python 3.10+
FastAPI
SQLAlchemy 2.0.21+
Pydantic 2.4.1+
async 데이터베이스 드라이버 (예: aiosqlite, asyncpg)

바로 차려먹기Python (uv)

깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.

git clone --depth 1 https://github.com/benavlabs/fastcrud.git &&
cd fastcrud &&
uv sync

uv가 없다면: brew install uv · 실행 명령은 README를 확인하세요.

코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.

README가 안내하는 자세한 단계 보기

FastCRUD 설치

pip install fastcrud

SQLAlchemy 모델 정의 (models.py)

# 내용은 README의 models.py 예제 참고

Pydantic 스키마 정의 (schemas.py)

# 내용은 README의 schemas.py 예제 참고

FastAPI 앱과 FastCRUD 설정 (main.py)

# 내용은 README의 main.py 예제 참고

앱 실행

uvicorn main:app --reload

깃밥트라이로 맛보기

받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.

터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.

npx gitbap-try benavlabs/fastcrud

Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →

별 추이 · 7일

1,537+7 / 7일

활용성 · 따라 만들기 좋은가

따라 하기 좋음샘플 점수 52/100

관대한 라이선스
테스트 있음
예제 디렉토리
최근 활동
AGENTS.md
llms.txt
템플릿

🟢 최근 활동 있음 · 2024년 생성

「백엔드·DB」 이런 레포, 매주 받아보실래요?

매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.

내 레포인가요? README에 깃밥 배지 달기

[![깃밥](https://www.gitbap.com/badge/benavlabs/fastcrud.svg)](https://www.gitbap.com/r/benavlabs/fastcrud)

🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp

방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork

/plugin install gitbap-cowork@gitbap

연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기