Typio: Make Your Terminal Type Like a Human

Typio is a lightweight Python library that prints text to the terminal as if it were being typed by a human. It supports multiple typing modes (character, word, line, sentence, typewriter, and adaptive), configurable delays and jitter for natural variation, and seamless integration with existing code via a simple function or a decorator. Typio is designed to be minimal, extensible, and safe, making it ideal for demos, CLIs, tutorials, and storytelling in the terminal.

PyPI Counter
Github Stars

Branch	main	dev
CI

Code Quality

• Download Version 0.9 or Latest Source
• pip install .

• Check Python Packaging User Guide
• pip install typio==0.9

Use type_print function to print text with human-like typing effects. You can control the typing speed, randomness, mode, and output stream.

from typio import type_print
from typio import TypeMode

type_print("Hello, world!")

type_print(
    "Typing with style and personality.",
    delay=0.06,
    jitter=0.02,
	end="\n",
    mode=TypeMode.ADAPTIVE,
)

You can also redirect the output to any file-like object:

with open("output.txt", "w") as file:
    type_print("Saved with typing effects.", file=file)

Use the @typestyle decorator to apply typing effects to all print calls inside a function, without changing the function's implementation.

from typio import typestyle
from typio import TypeMode

@typestyle(delay=0.05, mode=TypeMode.TYPEWRITER)
def intro():
    print("Welcome to Typio.")
    print("Every print is typed.")

intro()

Typio also allows defining custom typing modes.

A custom mode is a callable that receives a typing context and the text being printed.

This custom mode, named dramatic, adds exaggerated pauses after punctuation to create a dramatic typing effect.

from typio import TypioContext

def dramatic(ctx: TypioContext, text: str):
    for ch in text:
        ctx.emit(ch)
        if ch in ".!?":
            ctx.sleep(delay=ctx.delay * 6)

Usage with type_print function:

type_print(
    "Wait... what?!",
    mode=dramatic,
    delay=0.05,
    jitter=0.02,
)

Usage with @typestyle decorator:

@typestyle(delay=0.06, mode=dramatic)
def demo():
    print("This is serious.")
    print("Very serious!")

demo()

This table describes the TypioContext API, which is the interface exposed to custom typing modes for emitting text, controlling timing, and accessing delay settings.

Typio provides a simple command line interface for printing text with typing effects.

> typio --text="Hello world!" --mode=typewriter --delay=0.03

Just fill an issue and describe it. We'll check it ASAP!

• Please complete the issue template

Give a ⭐️ if this project helped you!