BilliqAI: All-in-One AI Generation Studio

A comprehensive platform for AI-powered content creation, combining image generation, video production, voice synthesis, and custom AI agents in one unified studio environment.

Overview

BilliqAI revolutionizes content creation by consolidating multiple AI generation capabilities into a single, powerful platform:

• Image Studio: Advanced AI image generation with brand consistency and batch processing
• Video Studio: Professional video creation with AI avatars, lip-sync, and multi-language dubbing
• Voice Studio: Natural voice synthesis with emotion control and voice cloning capabilities
• Agent Studio: Custom AI agent builder with visual workflow designer and business integrations
• Enterprise Security: SOC 2 compliant with comprehensive data protection and audit logging
• Unified Workflows: Seamless integration between all AI generation types, saving 50% vs separate tools

Repository Structure

/
├── apps/                  # Application packages
│   ├── web/               # Next.js frontend application
│   ├── api/               # NestJS API backend
│   └── worker/            # Background task processor
├── packages/              # Shared packages
│   ├── database/          # Database schemas and client
│   ├── ai/                # AI model integrations
│   ├── mcp/               # Message Control Protocol implementation
│   ├── ui/                # Shared UI components
│   └── config/            # Shared configuration
├── infrastructure/        # Deployment and infrastructure code
├── scripts/               # Development and utility scripts
└── docs/                  # Documentation

Getting Started

Prerequisites

• Node.js 20+
• pnpm 8+
• Docker and Docker Compose
• AWS Account (for production deployment)

Development Setup

1. Clone the repository:

   git clone https://github.com/yourusername/billiq-ai.git
   cd billiq-ai

2. Install dependencies:

   pnpm install

3. Set up environment variables:

   cp .env.example .env.dev
   # Edit .env.dev with your configuration

4. Start the development environment:

   # Using Docker (Recommended)
   pnpm run docker:dev
   
   # Or start specific services
   pnpm run dev:web    # Start web frontend only
   pnpm run dev:api    # Start API backend only

5. Access the application:

   • Web UI: http://localhost:3000
   • API: http://localhost:3001
   • API Documentation: http://localhost:3001/docs

Docker Development

For a complete development environment with all services:

# Start development stack
pnpm run docker:dev

# View logs
pnpm run docker:dev:logs

# Stop services
pnpm run docker:dev:down

# Clean up
pnpm run docker:clean

See DOCKER.md for detailed Docker setup and deployment instructions.

Available Scripts

Root Level Commands

• pnpm run dev:all - Start all services in parallel
• pnpm run dev:web - Start web frontend only
• pnpm run dev:api - Start API backend only
• pnpm run build - Build all packages
• pnpm run lint - Lint all packages
• pnpm run format - Format all code
• pnpm run test - Run tests across all packages

Docker Commands

• pnpm run docker:dev - Start development environment
• pnpm run docker:dev:down - Stop development environment
• pnpm run docker:dev:logs - View development logs
• pnpm run docker:prod - Start production environment
• pnpm run docker:prod:down - Stop production environment
• pnpm run docker:prod:observability - Start production with monitoring
• pnpm run docker:build:dev - Build development image
• pnpm run docker:build:prod - Build production image
• pnpm run docker:clean - Clean up Docker resources

API Specific Commands

• pnpm run dev:api - Start API in development mode
• pnpm run start:api - Start API in production mode
• cd apps/api && pnpm run build - Build API only
• cd apps/api && pnpm run test - Test API only

API Documentation

The NestJS API provides comprehensive documentation through Swagger UI:

• Swagger UI: http://localhost:3001/docs
• API Base URL: http://localhost:3001/api/v1

Available Endpoints

• GET /api/v1/users - Get all users (with pagination)
• GET /api/v1/users/:id - Get user by ID
• GET /api/v1/users/email/:email - Get user by email
• POST /api/v1/users - Create a new user
• PUT /api/v1/users/:id - Update user
• DELETE /api/v1/users/:id - Delete user

Git Workflow

We follow a standardized Git workflow to ensure code quality and consistent commits:

Commit Process

When you commit changes, the following automated steps happen:

1. Pre-commit Hook:

   • Stashes any unstaged changes temporarily
   • Formats staged files using Biome
   • Lints staged files using Biome
   • Adds the freshly formatted files to staging
   • Restores any previously unstaged changes

2. Commit Message Validation:

   • Enforces conventional commit format (e.g., feat: add new feature)
   • Valid types: feat, fix, docs, style, refactor, perf, test, chore, ci, build, revert

Commit Format

All commits must follow the Conventional Commits specification:

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]

Examples:

• feat: add user authentication
• fix(api): resolve rate limiting issue
• docs: update README with new instructions

Handling Pre-commit Issues

If the pre-commit hook fails:

1. Review the error messages
2. Fix the issues manually:

   pnpm format:write   # Fix formatting
   pnpm lint:fix       # Fix linting

3. Stage your changes and try committing again

Code Quality and Standards

We use Biome for code formatting and linting across the codebase. Biome provides a unified tool for both operations, resulting in faster and more consistent code.

Available Scripts

• Format code:

  pnpm format

• Lint code:

  pnpm check

• Fix linting issues:

  pnpm lint:fix

Pre-commit Hooks

The repository is configured with Git hooks that automatically:

• Format and lint staged files before committing
• Validate commit message format to ensure consistency

Editor Integration

It's recommended to install the Biome extension for your editor:

• VS Code
• Other editors

Technology Stack

• Frontend: Next.js 15, React 19, Tailwind CSS 4
• Backend: NestJS, TypeScript, Express
• Database: PostgreSQL, Prisma ORM
• Vector Database: Pinecone (for AI agent knowledge)
• Message Queue: BullMQ (Redis-based task processing)
• AI Providers: OpenAI, Stability AI, ElevenLabs, Runway (multi-provider support)
• Infrastructure: AWS (S3, CloudFront, EC2), Docker, Kubernetes
• Analytics: Kafka, Custom metrics
• Authentication: Better-auth with enterprise SSO
• Payments: Stripe with usage-based billing
• Code Quality: Biome (formatting and linting)
• Monitoring: Custom observability with AWS CloudWatch

Contributing

See CONTRIBUTING.md for detailed contribution guidelines.

License

This project is licensed under the MIT License - see the LICENSE file for details.