Skip to content
View Ommuo's full-sized avatar

Block or report Ommuo

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don't include any personal information such as legal names or email addresses. Markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
Ommuo/README.md

Ommuo - AI Music Generator Platform

An AI-powered music generation platform specializing in easy-listening genres (Jazz, Bossa Nova, Blues, Lo-fi Hip-hop, City Pop) for commercial distribution.

Architecture

Ommuo/
├── frontend/          # Next.js + React UI
│   ├── src/
│   │   ├── app/       # Next.js App Router pages
│   │   ├── components/# React components
│   │   ├── lib/       # Utilities and API client
│   │   └── styles/    # Global styles
│   └── package.json
├── backend/           # Python FastAPI backend
│   ├── app/
│   │   ├── api/       # API route handlers
│   │   ├── core/      # Config, security, dependencies
│   │   ├── models/    # Database models
│   │   ├── schemas/   # Pydantic schemas
│   │   ├── services/  # Business logic & AI integration
│   │   └── utils/     # Helper utilities
│   ├── tests/
│   └── requirements.txt
├── BUSINESS_PLAN.md   # Full business & market strategy
└── docker-compose.yml # Local development setup

Quick Start

Backend

cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

Frontend

cd frontend
npm install
npm run dev

Visit http://localhost:3000 to use the platform.

Features

  • Text-to-Music: Describe the song you want in natural language
  • Custom Lyrics: Input your own lyrics for AI to compose music around
  • Musical Parameters: Fine-tune tempo, key, instruments, mood
  • Reference Upload: Upload a reference song to match its style
  • Genre Presets: One-click presets for Jazz, Bossa Nova, Blues, Lo-fi, City Pop
  • Multi-language Songs: Generate songs in multiple languages
  • Export & Distribute: Download in multiple formats, ready for distribution
  • Project Management: Save, organize, and manage your generated songs
  • Batch Generation: Generate multiple variations at once

Tech Stack

  • Frontend: Next.js 14, React 18, TailwindCSS, Framer Motion
  • Backend: Python 3.11+, FastAPI, SQLAlchemy, Celery
  • AI: Suno API, MusicGen (Meta), Custom models (future)
  • Database: PostgreSQL (production), SQLite (development)
  • Storage: Local filesystem (dev), S3-compatible (production)

Popular repositories Loading

  1. Ommuo Ommuo Public

    Config files for my GitHub profile.

    TypeScript

  2. my_project my_project Public

    test for project 2 on github