LibreAI / Image / Janus
// image · deepseek-ai/Janus

Janus

DeepSeek's Janus series - unified multimodal models that both understand and generate images

★ 17.8k stars⑂ 2.2k forksMITupdated 2025-02
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

Janus is an open-source image project by deepseek-ai (deepseek-ai/Janus on GitHub). It has 17,754 GitHub stars and 2,232 forks, is released under the MIT license, and was last updated on GitHub on 1 February 2025.

GitHub stars
17,754
Forks
2,232
License
MIT
Last updated on GitHub
1 February 2025
Category
Image
Listing
Full install guide
// how it works

How it works

  1. Choose a model size

    Pick a Janus variant and size (for example Janus-Pro-7B or the 1.3B models) that fits your GPU.

  2. Clone the repository

    Get the code, which includes inference examples and demos for each model in the series.

  3. Install dependencies

    Create a Python 3.8+ environment and install the package in editable mode.

  4. Run your first inference

    Load the weights from Hugging Face and run multimodal understanding or text-to-image generation.

// features

Why people love it

Unified understanding and generation

One model answers questions about images and generates images from text.

Decoupled visual encoding

Separate visual pathways for understanding and generation avoid the conflict that limited earlier unified models.

Janus-Pro improvements

An optimized training strategy, expanded data and larger scale improve instruction following and generation stability.

JanusFlow variant

Integrates rectified flow generation within the LLM framework for efficient unified modeling.

Gradio demos

Local Gradio apps (and hosted Hugging Face Spaces demos) for interactive testing.

FastAPI server

A FastAPI demo exposes the same functions as an API server.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source code from GitHub and enter the project directory.

    git clone https://github.com/deepseek-ai/Janus.git
    cd Janus
  2. Install the package

    Install Janus and its dependencies into your Python environment.

    pip install -e .
  3. Run a demo

    Launch the Janus-Pro Gradio demo, or the FastAPI demo for API access.

    python demo/app_januspro.py
    # API variant: python demo/fastapi_app.py
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains this project?

It is maintained by DeepSeek AI as an open-source research release on GitHub.

Is it free to use?

The code is MIT licensed; the model weights are under DeepSeek's model agreement (LICENSE-MODEL in the repo), so read that before commercial use.

Does it need a paid API key?

No API key or fee: models run locally on your GPU after a free Hugging Face download.

How does it compare to alternatives?

Compared with separate specialist models (a VLM plus an image generator), Janus unifies both in one model; compared with hosted APIs, it is fully self-hosted but needs your own GPU.

How do I get started?

Clone the repo, run pip install -e ., download a checkpoint from Hugging Face, and start the Gradio demo.

// keep exploring

Similar tools

Image

Bagel

ByteDance's open-source unified multimodal model for understanding, generation and image editing.

★ 6.2k starsApache-2.0
View guide →
Image

Real-ESRGAN

Real-ESRGAN — practical blind super-resolution for real-world photos and video: restores and upscales degraded images with models trained on pure synthetic data, BSD-3-Clause

★ 37.1k starsBSD-3-Clause
View guide →
Image

OGAM

The Swiss Army Knife of Offline AI. Chat, see, speak, and generate images on your phone or Mac — GGUF LLMs, vision, Whisper speech-to-text, Stable Diffusion,…

★ 3.2k starsMIT
View guide →
Image

UpscalerJS

Enhance images in JavaScript — upscale, denoise, deblur and dehaze with AI

★ 901 starsMIT
View guide →
Image

ImageUpscaler

Simple Flask web app that upscales low-res images with AI

★ 129 starsMIT
View guide →
Image

MuseUI

Browser-only AI interface for UI mockups, covers, logos and social images

★ 56 starsMIT
View guide →
// alternatives

Alternatives in Image

The most-starred other Image projects in the LibreAI catalogue — the realistic shortlist if Janus is not the right fit.

Get Janus

Free and open — grab the source, star the repo, and start creating.