whatisgithub

What is artline?

vijishmadhavan/artline — explained in plain English

Analysis updated 2026-05-18

3,625Jupyter NotebookAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A deep learning model that turns portrait photos into hand-drawn style line art, runnable free in a browser via Google Colab.

Mindmap

mindmap
  root((ArtLine))
    What it does
      Photo to line art
      Portrait focused
    Modes
      Fast smoother model
      Slow high quality model
      ControlNet text guided
    Training
      Portrait sketch dataset
      Anime sketch colorization
      DeOldify inspired architecture
    Limitations
      Needs good lighting
      Confuses shadows with hair
      Low res photos struggle

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Turn a portrait photo into a black-and-white line drawing using the Colab notebook.

USE CASE 2

Choose between a faster smoother model or a slower higher-quality one.

USE CASE 3

Combine ArtLine with ControlNet to guide the drawing style with a text instruction.

USE CASE 4

Create stylized portrait art for personal projects like posters or profile images.

What is it built with?

PythonJupyter NotebookGoogle ColabPyTorch

How does it compare?

vijishmadhavan/artlinepaddlepaddle/awesome-deeplearningdatawhalechina/thorough-pytorch
Stars3,6253,6263,632
LanguageJupyter NotebookJupyter NotebookJupyter Notebook
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencegeneraldeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Runs directly in Google Colab with no local install, low-res or poorly lit photos give weak results.

MIT license: free to use, modify, and distribute, including commercially, as long as you keep the copyright notice.

So what is it?

ArtLine is a machine learning project that converts portrait photos into line art drawings. You give it a photo of a person's face, and it outputs a black-and-white line drawing in the style of a hand-drawn portrait sketch. The project is focused specifically on faces and portraits rather than general images. The simplest way to try it is through a Google Colab notebook, which runs in a browser without any installation. Two versions are available: a faster model that produces smoother results and a slower one that aims for higher quality. There is also a newer mode that combines ArtLine with a tool called ControlNet, where you can provide both a photo and a written instruction to influence the style of the output. The creator trained the model by combining two datasets: one containing portrait photos paired with hand-drawn sketches, and one from anime sketch colorization. The combination helped the model learn to handle a wider variety of poses rather than only straight-on face photos. The technical approach uses a neural network architecture designed for image-to-image tasks, with techniques borrowed from a related project called DeOldify. The model has acknowledged limitations: it works best with well-lit, high-quality photos against clean backgrounds, and it tends to confuse shadows with hair. Images below 500 pixels wide often produce poor results. The project was created by someone who describes themselves as not primarily a coder, and it is an ongoing personal project that has been updated over time. Source code is under the MIT license.

Copy-paste prompts

Prompt 1
Explain how to run the ArtLine Colab notebook on my own photo.
Prompt 2
What kind of photos work best with ArtLine, and what should I avoid?
Prompt 3
How does ArtLine's ControlNet mode let me guide the output style with text?
Prompt 4
Explain how ArtLine was trained using portrait and anime sketch datasets.

Frequently asked questions

What is artline?

A deep learning model that turns portrait photos into hand-drawn style line art, runnable free in a browser via Google Colab.

What language is artline written in?

Mainly Jupyter Notebook. The stack also includes Python, Jupyter Notebook, Google Colab.

What license does artline use?

MIT license: free to use, modify, and distribute, including commercially, as long as you keep the copyright notice.

How hard is artline to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is artline for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.