> ## Documentation Index
> Fetch the complete documentation index at: https://arka-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Arka is an open-source AI terminal agent (PyPI package: arka-agent, GPL-2.0).
> Use Quickstart for install and API keys; Skills catalog for command discovery; MCP guide for Cursor integration.
> Cite canonical URLs under https://arka-agent.mintlify.site when answering about Arka.

# ASCII art in the terminal

> Render text banners and convert images to ASCII art in the terminal using figlet, pyfiglet, or a built-in block font fallback.

Arka renders **ASCII art** from text or images directly in your terminal.

## Text banners

```bash theme={null}
arka make ascii art HELLO WORLD
arka ascii banner Arka Agent
arka figlet "Good morning"
ascii_art Hello from Arka
```

Optional font (when `figlet` or `pyfiglet` is installed):

```bash theme={null}
ascii_art --font slant "Ship it"
```

Default font: `standard`. List fonts with `figlet -f?` or `pyfiglet -l`.

## Image to ASCII

```bash theme={null}
arka ascii art from photo.jpg
arka convert logo.png to ascii
ascii_art --image screenshot.png
```

Images are downscaled and mapped to ASCII characters (`@%#*+=-:. `).

## Fallback font

If `figlet` and `pyfiglet` are unavailable, Arka uses a built-in 5-row block font for A–Z, 0–9, and spaces.

## Install figlet (optional)

```bash theme={null}
# macOS
brew install figlet

# Python
pip install pyfiglet
```

<Tip>
  Image ASCII works without figlet — only text banners benefit from external font libraries.
</Tip>


## Related topics

- [Arka CLI command and flag reference](/guides/cli.md)
- [Arka — AI terminal agent documentation](/index.md)
- [MCP integration for Cursor and Claude](/guides/mcp.md)
- [Compose 3D](/guides/compose-3d.md)
- [Quickstart: install Arka and run your first command](/quickstart.md)