English | 中文

Sven Family is an AI-native product suite that connects creation, collaboration, publishing, and operations into one integrated platform.

• What's Inside
• Preview
• Project Structure
• Tech Stack
• Quick Start
• Service Map
• Documentation
• Contributing
• License

Sven Family combines four product experiences with shared backend services:

Core value:

• One platform for creators, operators, and community members
• End-to-end flow from content generation to distribution and governance
• Extensible architecture for multi-app and multi-service growth

sven/
├── frontend/
│   ├── admin-frontend/    # Admin dashboard (Vite + React)
│   ├── community/         # Community web app (Next.js)
│   └── site/              # Landing / product site (Next.js)
├── backend/
│   ├── admin-backend/     # Admin API service (Python)
│   ├── community-backend/ # Community API service (Python)
│   ├── crawler/           # Data collection service (Python)
│   └── stats-service/     # Analytics service (Python)
├── studio/
│   ├── frontend/          # Studio web editor
│   ├── desktop/           # Studio desktop app (Electron)
│   └── backend/           # Studio API service (Python)
└── assets/                # Documentation images and static resources

• Node.js >= 20
• pnpm >= 11
• Python >= 3.11
• uv (recommended Python package manager)
• Docker & Docker Compose (recommended for full-stack development)
• PostgreSQL 15 and Redis 7 (provided via Docker)

git clone https://github.com/laishiwen/sven-family.git
cd sven-family
pnpm install

Copy the example environment files for the backend and frontend services you plan to run:

# Backend
cp backend/admin-backend/.env.example backend/admin-backend/.env
cp backend/community-backend/.env.example backend/community-backend/.env
cp backend/crawler/.env.example backend/crawler/.env
cp backend/stats-service/.env.example backend/stats-service/.env

# Frontend
cp frontend/community/.env.example frontend/community/.env
cp frontend/site/.env.example frontend/site/.env
cp studio/frontend/.env.example studio/frontend/.env

Edit each .env file with your local database credentials and secrets.

docker compose up -d postgres redis

cd backend/admin-backend && uv run alembic upgrade head
cd ../community-backend && uv run alembic upgrade head

# Start all frontends
pnpm dev

# Start Studio (web + API)
pnpm dev:studio:full

# Start all frontends
pnpm dev:front

# Start all backend services
pnpm dev:back

# Start with Docker Compose (full stack)
pnpm dev:docker

pnpm dev:stop

• Contributing Guide
• Code of Conduct
• Security Policy
• Roadmap
• Changelog

We welcome contributions. Please read the Contributing Guide before submitting a pull request.

By contributing, you agree that your contributions will be licensed under the MIT License.

This project is licensed under the MIT License.

Thanks to all contributors and the open-source communities behind Node.js, Python, React, Next.js, Vite, Tailwind CSS, and FastAPI.