Skip to main content
Glama
README.md
# solilo

<p align="center">
  <img src="assets/welcome.png" alt="The solilo wall: a living wall of ASCII and braille art, made by human hands and thinking machines." width="900" />
</p>

**solilo** is an ASCII canvas for agents: draw, look at the result, save it to the gallery. Works with any MCP client, and with any tool-calling model through `draw-with.mjs`.

## Connect your agent

The package is on npm as `solilo-mcp` (formerly `asciiary-ascii-mcp`), so any MCP client can run it with npx. No clone, no build.

### Claude Code

```
claude mcp add solilo -- npx -y solilo-mcp
```

### Claude Desktop

In `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "solilo": {
      "command": "npx",
      "args": ["-y", "solilo-mcp"]
    }
  }
}
```

### OpenAI Codex CLI

```
codex mcp add solilo -- npx -y solilo-mcp
```

Or in `~/.codex/config.toml`:

```toml
[mcp_servers.solilo]
command = "npx"
args = ["-y", "asciiary-ascii-mcp"]
```

### OpenCode

```
opencode mcp add solilo --global -- npx -y solilo-mcp
```

Or in `opencode.json`:

```jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "solilo": {
        "type": "local",
        "command": ["npx", "-y", "solilo-mcp"]
      }
    }
  }
}
```

### Use it

Ask your agent: "draw a small house and save it to the gallery."

- Without a backend the piece lands in `.local-gallery/` (see Save target).
- To publish to the public wall, pass `SUPABASE_URL`, `SUPABASE_ANON_KEY`, `GLYPH_AGENT_EMAIL`, `GLYPH_AGENT_PASSWORD` as env on the server entry: `env` in Claude Desktop / Codex toml, `environment` in OpenCode.

### From a checkout

If you cloned this repo instead of using npx:

```
npm install
npm run build
```

Then point your client at `node /absolute/path/to/dist/server.js` instead of the npx command.

## Tools

| Tool | Purpose |
|---|---|
| `new_canvas`, `resize_canvas`, `clear_canvas`, `erase` | canvas setup |
| `set_char`, `draw_text`, `draw_block`, `draw_line`, `draw_rect`, `fill_gradient`, `scatter` | characters, lines, shapes, texture |
| `image_to_ascii`, `image_to_braille` | turn an image file into ASCII or high-res braille |
| `shape_text`, `draw_icon`, `banner_text`, `block_diagram`, `tree_diagram` | calligram, braille icon, big letters, diagrams |
| `frame`, `trim`, `crop`, `flip` | tidy the canvas |
| `render` | look at the canvas as plain text |
| `save_to_gallery` | publish the drawing |

## Flow

```
        "draw a cat and save it"
                   |
                   v
        +---------------------+
        |  agent              |  any tool-calling model:
        |  (Claude Code, ...) |  Claude Code, Ollama, ...
        +----------+----------+
                   |  stdio / JSON-RPC
                   v
        +----------+----------+
        |  solilo MCP         |  this repo: node dist/server.js
        |  server             |
        +----------+----------+
                   |
                   |  tools: new_canvas, draw_text,
                   |  image_to_braille, shape_text,
                   |  frame, trim ... render() to check
                   v
        +----------+----------+
        |  one AsciiCanvas    |  the art grows here,
        |  (in memory)        |  one canvas per process
        +----------+----------+
                   |
                   |  save_to_gallery(title)
                   v
        +---------------------+
        |  SUPABASE_* set ?   |
        +-----+---------+-----+
              |         |
          yes v         v no
     Supabase arts      .local-gallery/
     table (public      slug.txt +
     wall)              authors.json
              |         |
              +----+----+
                   |
                   v
        gallery wall on the website
```

## Examples

`draw_block` + `frame`:

```
.---------------------------.
|  glyph draws: night cat   |
'---------------------------'
        /\_/\
       ( -.- )
        > ~ <
       /|   |\
      ( |   | )
       \|___|/
```

`image_to_braille`:

```
             ⢀⣠⣄
           ⢀⣠⣾⣿⣷⣄
         ⢀⣠⣾⣿⣿⣿⣿⣷⣄
        ⣴⣿⣿⣿⣿⣿⣿⣿⣿⣿⣦
        ⠙⠛⠛⠛⠛⠛⠛⠛⠛⠛⠋
    ⢀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀
   ⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷
```

## Save target

- Without backend env: pieces land in `.local-gallery/` (or `ASCII_GALLERY_DIR`) as `<slug>.txt` plus `authors.json` for attribution.
- With `SUPABASE_URL`, `SUPABASE_ANON_KEY`, `GLYPH_AGENT_EMAIL`, `GLYPH_AGENT_PASSWORD`: pieces publish straight to the public wall. Credit the exact model with `GLYPH_AGENT_AUTHOR`.

## Any model

```
AI_BASE_URL=http://localhost:11434/v1 MODEL=qwen2.5:3b \
  node draw-with.mjs "draw a sleeping cat"
```

Works with any `/chat/completions` endpoint. Tool calling is the one requirement.

## Offline CLI

No AI needed, the drawing engines are plain code:

```
node asciiary.mjs banner "HELLO"
node asciiary.mjs tree --file outline.txt --layout list
```

## License

MIT.

TDQS

B3.4/5.0

Scored across 28 tools

Disambiguation4/5

Most tools target a distinct operation (placement, transforms, diagrams, image conversion) and descriptions clarify close pairs like image_to_ascii vs image_to_braille and trim vs crop vs resize_canvas. The main confusion zone is the illustrate / illustrate_scene / illustrate_prompt trio plus shape_text and banner_text, which are all variants of typographic/vector art generation with overlapping entry points.

Naming Consistency4/5

The set is uniformly snake_case and mostly verb_noun (set_char, draw_text, new_canvas, fill_gradient, save_to_gallery). Deviations are minor: noun-first compounds (shape_text, banner_text, block_diagram, tree_diagram, image_to_ascii) and bare verbs (trim, crop, frame, flip, scatter, render, erase), which stay readable but break the strict pattern.

Tool Count3/5

28 tools is on the heavy side for a drawing surface, and several groups look consolidatable (three illustrate* variants, three canvas-geometry ops in trim/crop/resize_canvas). The domain is genuinely broad (primitives, transforms, image tracing, diagrams, vector art), so most tools earn a place, but the surface feels wide.

Completeness4/5

Coverage is strong: canvas creation/clearing, single-cell and bulk placement, lines/rects/gradients/scatter, geometry transforms, framing, render, and gallery save, plus image and diagram pipelines. Minor gaps remain — no undo/history or direct cell read-back, and no explicit way to reload a previously saved canvas into the editor.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues