typio 0.3

Typio: Make Your Terminal Type Like a Human

Typio: Make Your Terminal Type Like a Human

Overview

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

Installation

Source Code

• Download Version 0.3 or Latest Source
• pip install .

PyPI

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

Usage

Function

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

Example

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)

Parameters

Name	Type	Description
text	str	Text to be printed
delay	float	Base delay (seconds) between emitted units
jitter	float	Random delay variation (seconds)
mode	TypeMode | Callable	Typing mode (built-in or custom)
file	TextIOBase | None	Output stream (defaults to sys.stdout)

Built-in Modes

Mode	Description
TypeMode.CHAR	Emit text character by character
TypeMode.WORD	Emit text word by word, preserving whitespace
TypeMode.LINE	Emit text line by line
TypeMode.SENTENCE	Emit text character by character with longer pauses after ., !, ?
TypeMode.TYPEWRITER	Emit text character by character with longer pauses after newlines
TypeMode.ADAPTIVE	Emit text with adaptive delays based on character type (spaces, punctuation, alphanumeric)

Decorator

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

Example

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()

Parameters

Name	Type	Description
delay	float	Base delay (seconds) between emitted units
jitter	float	Random delay variation (seconds)
mode	TypeMode | Callable	Typing mode (built-in or custom)

Custom Mode

Typio also allows defining custom typing modes.

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

Example

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()

Parameters

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

Name	Type	Description
emit(text)	method	Emit a text fragment using typing effects
sleep(delay=None, jitter=None)	method	Pause execution with optional delay and jitter override
flush()	method	Flush the underlying output stream
delay	property	Base delay in seconds
jitter	property	Jitter value in seconds

Issues & Bug Reports

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

• Please complete the issue template

Show Your Support

Star This Repo

Give a ⭐️ if this project helped you!

Donate to Our Project

Bitcoin

1KtNLEEeUbTEK9PdN6Ya3ZAKXaqoKUuxCy

Ethereum

0xcD4Db18B6664A9662123D4307B074aE968535388

Litecoin

Ldnz5gMcEeV8BAdsyf8FstWDC6uyYR6pgZ

Doge

DDUnKpFQbBqLpFVZ9DfuVysBdr249HxVDh

Tron

TCZxzPZLcJHr2qR3uPUB1tXB6L3FDSSAx7

Ripple

rN7ZuRG7HDGHR5nof8nu5LrsbmSB61V1qq

Binance Coin

bnb1zglwcf0ac3d0s2f6ck5kgwvcru4tlctt4p5qef

Tether

0xcD4Db18B6664A9662123D4307B074aE968535388

Dash

Xd3Yn2qZJ7VE8nbKw2fS98aLxR5M6WUU3s

Stellar

GALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNL

Zilliqa

zil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5

Coffeete

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

Unreleased

0.3 - 2026-02-11

Added

• TypioContext class

Changed

• Test system modified
• README.md updated
• _TypioPrinter class all attributes changed to private
• _emit method modified
• _sleep function modified

0.2 - 2026-02-04

Changed

• README.md updated
• end parameter added to type_print function
• Test system modified

0.1 - 2026-01-31

Added

• type_print function
• typestyle decorator
• CHAR mode
• WORD mode
• LINE mode
• SENTENCE mode
• TYPEWRITER mode
• ADAPTIVE mode