AIdol Backend
AI 아이돌 그룹 생성 및 채팅 Python 패키지
주요 기능
- AI 아이돌 그룹/멤버 CRUD
- Google Gemini 이미지 생성 (엠블럼, 프로필)
- 텍스트 채팅 (페르소나 기반 응답)
- Buppy 통합 Adapter 패턴
설치
cd backend
poetry install
poetry run uvicorn main:app --reload
API 문서:
- Swagger UI: http://localhost:8000/docs
- ReDoc: http://localhost:8000/redoc
사용법
FastAPI 통합
from aidol.api.aidol import AIdolRouter
from aidol.api.companion import CompanionRouter
from aidol.factories import AIdolRepositoryFactory, CompanionRepositoryFactory
# AIdol 라우터
aidol_router = AIdolRouter(
repository_factory=AIdolRepositoryFactory(),
google_settings=google_settings,
image_storage=image_storage,
)
# Companion 라우터
companion_router = CompanionRouter(
repository_factory=CompanionRepositoryFactory(),
)
app.include_router(aidol_router.router, prefix="/api/aidol")
app.include_router(companion_router.router, prefix="/api/aidol")
개발
poetry install
make lint
make type-check
make unit-test
make format
환경 변수
이미지 생성 인증 (선택, ADC 지원)
| 변수 | 설명 |
|---|---|
GOOGLE_API_KEY |
Google API 키 (Google AI API) |
GOOGLE_CLOUD_PROJECT |
GCP 프로젝트 ID (Vertex AI) |
인증 방법:
Option 1: Google AI API (API Key)
export GOOGLE_API_KEY=your-api-key
Option 2: Vertex AI (ADC)
export GOOGLE_CLOUD_PROJECT=your-project-id
gcloud auth application-default login # 로컬 개발
참고: Vertex AI 사용 시
location=global이 하드코딩되어 있습니다 (Gemini 이미지 생성 모델 요구사항).
선택
| 변수 | 기본값 | 설명 |
|---|---|---|
AIDOL_OPENAI_MODEL |
gpt-4o-mini |
채팅 응답 LLM 모델 |
참고: 데이터베이스, 모델 등 추가 설정은 기본값으로 로컬 개발 가능합니다. 변경이 필요한 경우
aidol/내 Settings 클래스를 참고하세요.
의존성
- aioia-core (공통 인프라)
- FastAPI, SQLAlchemy, Pydantic
- Google Generative AI (이미지 생성)
- OpenAI (채팅)
- Pillow (이미지 처리)
라이선스
Apache 2.0
1 maintainer
Metadata
1 maintainer
Release files for py-aidol 2.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| py_aidol-2.8.1.tar.gz | 64.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| py_aidol-2.8.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 152.4 kB
Release files / py_aidol-2.8.1.tar.gz
| Download URL | py_aidol-2.8.1.tar.gz |
|---|---|
| Size | 64.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1d8df08ec48162233f760f3651d97b52b4b80b7a9c9c2c4161f53f0f5ce26ec1
|
|
BLAKE2b-256 checksum How to use checksums |
203d0390afa1f07088a05ba2e8477f56b68733630fcf89749148f665ea1a5d0a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 4, 2026.
Transparency logRelease files / py_aidol-2.8.1-py3-none-any.whl
| Download URL | py_aidol-2.8.1-py3-none-any.whl |
|---|---|
| Size | 87.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
08e989d811242ca8ecbdcc083caca066120583bcf40c4e434880d4045a711385
|
|
BLAKE2b-256 checksum How to use checksums |
163af5aa3a216724ab4eb888204a4ff60f522960280b2a3479c432bc2a28567b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 4, 2026.
Transparency log
