Powered by the axum web framework for async concurrency without garbage collection overhead. Exposes first-class Prometheus observability, mimalloc-accelerated allocation, and compile-time registry never breaks the codebase.
Managing tag registries across multiple Discord bots is a maintenance nightmare. When a new character-series drops, every bot project must be edited individually — update the list, rebuild, redeploy. Teams maintaining 5, 10, or 20 bots end up copy-pasting the same 100+ character array across repos, creating drift between deployments. One bot gets "sandrone_(genshin_impact)", "lauma_(genshin_impact)", "anis_(star)_(nikke)", and etc.. with correct formatting, another uses a stale alias. There is no single source of truth, no centralized versioning, and no way to propagate updates without touching each codebase by hand.
@ScathachGrip/teivax decouples the tag registry from all bot code. Instead of embedding character lists in every project, point all your bots at a single HTTP endpoint. Add or update tags in one place — teivax — and every bot picks up the change on its next request. The registry is compile-time constant, served with sub-millisecond latency, and needs no database, no cache warming, and no runtime synchronization. One cargo build propagates new characters to every consumer.
┌──────────────────────────────┐
│ HTTP Client │
│ (curl / browser / bots) │
└──────────────┬───────────────┘
│
│ GET /, /:id, /health
│ GET /metrics, /loadavg
v
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│ axum HTTP Server (0.7) │
│ │
│ ┌──────────────────────────────────────┐ ┌──────────────────────────────────────────┐ │
│ │ data_router │ │ metrics_router │ │
│ │ (CORS permissive, tracing, prom) │ │ (no CORS, direct scrape) │ │
│ │ │ │ │ │
│ │ GET / │ │ GET /metrics │ │
│ │ GET /:id │ │ GET /debug/mimalloc │ │
│ │ GET /health │ └──────────────────────┬───────────────────┘ │
│ │ GET /loadavg │ │ │
│ │ GET /data │ v │
│ │ GET /global_anime_girls │ ┌──────────────────────────────────────────┐ │
│ │ GET /blocklists │ │ prometheus metrics │ │
│ │ GET /playground │ │ (axum-prometheus + metrics 0.23) │ │
│ └──────────────────┬───────────────────┘ └──────────────────────────────────────────┘ │
│ │ │
│ v │
│ ┌──────────────────────────────────────┐ │
│ │ handlers │ │
│ │ index() → REGISTRY │ │
│ │ get_anime() → by_id() │ │
│ │ health() → "ok" │ │
│ │ loadavg() → sysinfo::System │ │
│ └──────────────────┬───────────────────┘ │
│ │ │
│ v │
│ ┌──────────────────────────────────────┐ │
│ │ data.rs │ │
│ │ Anime struct │ │
│ │ REGISTRY: &[Anime] │ │
│ │ by_id(id) → Option<&Anime> │ │
│ └──────────────────┬───────────────────┘ │
│ │ │
│ ┌─────────┴─────────┐ │
│ v v │
│ ┌────────────────┐ ┌────────────────┐ │
│ │ nikke.rs │ │ arknights.rs │ ... 25 more tag files │
│ │ 106 tags │ │ 70 tags │ │
│ └────────────────┘ └────────────────┘ │
│ │
│ ┌────────────────────────────────────────────────────────────────────────────────────────────┐ │
│ │ Background Tasks (tokio::spawn) │ │
│ │ │ │
│ │ ┌────────────────────────────────────────┐ ┌────────────────────────────────────────┐ │ │
│ │ │ system_updater() │ │ dump_json() │ │ │
│ │ │ every N seconds: │ │ on startup: │ │ │
│ │ │ • sysinfo::System::* │ │ • write json/{id}.json │ │ │
│ │ │ • CPU / mem / disk / net │ │ • best-effort │ │ │
│ │ │ • process info / threads │ └────────────────────────────────────────┘ │ │
│ │ └────────────────────────────────────────┘ │ │
│ └────────────────────────────────────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────┬───────────────────────────────────────────────────┘
│
v
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│ Filesystem │
│ │
│ json/ │
│ ├── nikke.json <── dump_json() writes │
│ ├── arknights.json │
│ ├── genshin.json │
│ ├── global_anime_girls.json │
│ ├── blocklists.json │
│ └── ... │
│ │
│ playground/ │
│ └── index.html <── gen_playground binary │
└──────────────────────────────────────────────┬───────────────────────────────────────────────────┘
│
v
┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│ Global State (const) │
│ │
│ ┌────────────────────────────────────────────────────────────────────────────────────────────┐ │
│ │ REGISTRY (compile-time) │ │
│ │ &[Anime; 25] │ │
│ │ • id: &'static str │ │
│ │ • title: &'static str │ │
│ │ • provider: &'static str │ │
│ │ • tags: &'static [&'static str] │ │
│ └────────────────────────────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌────────────────────────────────────────────────────────────────────────────────────────────┐ │
│ │ AppState (runtime) │ │
│ │ started: Instant │ │
│ └────────────────────────────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌────────────────────────────────────────────────────────────────────────────────────────────┐ │
│ │ mimalloc::MiMalloc (global allocator) │ │
│ │ /debug/mimalloc exposes extended stats │ │
│ └────────────────────────────────────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────────────────────────────────────┘
| NOTE: Rust 1.96.0 or higher / or simply just use docker |
Rust toolchain with cargo is required. The build is self-contained — no external services, no database, no runtime config beyond env vars. Choose one of:
docker pull ghcr.io/scathachgrip/teivax:latest
docker run -p 3000:3000 -d ghcr.io/scathachgrip/teivax:latestcargo build
./target/debug/teivax# Windows
.\build.cmd
.\target\debug\teivax.exe| Env | Default | Notes |
|---|---|---|
PORT |
3000 |
TCP bind on 0.0.0.0 |
RUST_LOG |
info |
tracing EnvFilter |
.env auto-created from .env.schema on first run.
| Route | Returns | Description |
|---|---|---|
GET / |
JSON | Alive check — version, server location, memory stats |
GET /data |
JSON | Registry index — all supported anime with tag counts |
GET /:id |
JSON | Tag data for an ID (e.g. /nikke, /data_gif) |
GET /global_anime_girls |
JSON | Global anime girls dataset |
GET /blocklists |
JSON | Blocklist entries per category |
GET /playground |
HTML | Browser UI (requires gen_playground) |
GET /health |
text | "ok" |
GET /loadavg |
JSON | System load average {one, five, fifteen} |
GET /metrics |
text | Prometheus metrics |
GET /debug/mimalloc |
JSON | mimalloc allocator stats |
{
"entries": [
{
"id": "nikke",
"title": "Nikke",
"provider": "rule34",
"tag_count": 106,
"endpoint": "/nikke"
}
],
"endpoints": [
"/health",
"/metrics",
"/data",
"/global_anime_girls",
"/blocklists"
]
}Unknown ID returns 404 Not Found with body unknown anime: <id>.
| ID | Title | Provider | Type | Entries |
|---|---|---|---|---|
genshin |
Genshin Impact | rule34 | tags | 79 |
fgo |
Fate/Grand Order | rule34 | tags | 118 |
nikke |
Nikke | rule34 | tags | 106 |
arknights |
Arknights | rule34 | tags | 70 |
bluearchive |
Blue Archive | rule34 | tags | 73 |
azurlane |
Azur Lane | rule34 | tags | 66 |
genshin_danbooru |
Genshin Impact (Danbooru) | danbooru | tags | 36 |
honkai_starrail |
Honkai: Star Rail | rule34 | tags | 50 |
girls_frontline |
Girls' Frontline | rule34 | tags | 39 |
naruto |
Naruto | rule34 | tags | 30 |
bleach |
Bleach | rule34 | tags | 31 |
vtubers |
VTubers | danbooru | tags | 196 |
danbooru_sex |
Danbooru Sex Tags | danbooru | tags | 64 |
data_gif |
GIFs | others | gif | 2792 |
data_gif_nsfw |
NSFW GIFs | others | gif | 5194 |
gif_sex |
GIF Sex Tags | others | tags | 30 |
hentai_yandere |
Hentai Yandere Tags | yandere | tags | 49 |
ai_sex |
AI Sex Tags | others | tags | 3 |
wuthering_waves |
Wuthering Waves | rule34 | tags | 34 |
zenless_zone_zero |
Zenless Zone Zero | danbooru | tags | 42 |
uma_musume |
Uma Musume | rule34 | tags | 59 |
honkai_impact |
Honkai Impact 3rd | danbooru | tags | 27 |
one_piece |
One Piece | rule34 | tags | 8 |
league_of_legends |
League of Legends | rule34 | tags | 23 |
persona |
Persona | danbooru | tags | 21 |
| global_anime_girls | — | — | — | special dataset |
| blocklists | — | — | — | blocklist entries |
On startup, the server writes json/{id}.json for each anime and json/global_anime_girls.json, json/blocklists.json. Best-effort — failures logged, not fatal.
You can check available tests on cargo/config.toml and Makefile.toml.
Audit tag registries against live API post counts:
cargo make check-entries <name>Examples:
# danbooru-provider
cargo make check-entries genshin_danbooru
cargo make check-entries vtubers
cargo make check-entries danbooru_sex
cargo make check-entries honkai_impact
cargo make check-entries zenless
cargo make check-entries persona
# rule34-provider
cargo make check-entries genshin
cargo make check-entries fgo
cargo make check-entries nikke
cargo make check-entries arknights
cargo make check-entries bluearchive
cargo make check-entries azurlane
cargo make check-entries honkai_starrail
cargo make check-entries girls_frontline
cargo make check-entries naruto
cargo make check-entries bleach
cargo make check-entries uma_musume
cargo make check-entries one_piece
cargo make check-entries league_of_legends
cargo make check-entries wuthering_wavesTo ensure nasty tags or ambiguous wildcard exists, manual clean up is required.
This will surface a new file target/check_<name>_output.txt example:
TAG POST_COUNT
---------------------------------------------------------------------------
raiden_shogun 23755
ganyu_(genshin_impact) 15595
yae_miko 14832
lumine_(genshin_impact) 14759
mona_(genshin_impact) 13786
hu_tao_(genshin_impact) 12982
eula_(genshin_impact) 10210
=== SUMMARY ===
Total: 79
Total posts: 258407
Output: E:\Ferris\teivax\target\check_genshin_output.txt
[cargo-make] INFO - Build Done in 110.88 seconds.| Command | Description |
|---|---|
cargo build |
Build debug |
cargo make build |
Same, via cargo-make |
cargo dev |
cargo run alias |
cargo make run |
Run server binary |
cargo release |
cargo run --release --bin teivax alias |
cargo make check |
cargo check |
cargo make lint |
Clippy with deny warnings |
cargo make fmt |
Format all |
cargo make test |
Run tests |
cargo make qlty |
Run Qlty check (linters + analyzers) |
cargo make qlty-smells |
Qlty code smells only |
cargo make check-entries <name> |
Audit tag registry live counts |
See .cargo/config.toml for aliases and Makefile.toml for cargo-make tasks.
cargo run --bin gen_playgroundGenerates playground/index.html — a browser UI for browsing tags. Served at /playground. Deployed to GitHub Pages via CI.
Prometheus metrics at /metrics:
- System: CPU, memory, swap, loadavg, disk, network
- Process: CPU, RSS, virtual mem, threads, disk I/O, status
- mimalloc: commit, RSS, reserved, fragmentation, arenas, heaps, threads
- App: HTTP request count/duration, JSON dump timing, anime tag counts
- Tokio: worker thread count
| Concern | Crate | Version |
|---|---|---|
| HTTP server | axum |
0.7 |
| Runtime | tokio |
1 |
| Allocator | mimalloc (extended) |
0.1 |
| Metrics | axum-prometheus + metrics |
0.7 / 0.23 |
| System info | sysinfo |
0.32 |
| Serialization | serde + serde_json |
1 |
| Logging | tracing + tracing-subscriber |
0.1 / 0.3 |
| HTTP middleware | tower-http (cors, trace) |
0.5 |
| Env loading | dotenvy |
0.15 |
- Create
src/data/my_config.rs:pub const TAGS: &[&str] = &[ "character_name_(my_config)", ];
- Add
pub mod my_config;tosrc/data.rs - Add entry to
REGISTRY:Anime { id: "my_config", title: "my_config", provider: "rule34", tags: my_config::TAGS },
cargo build
process_open_fdsalways0.0—open_files()requiressysinfo >= 0.33, project pinned at0.32system_cpu_brandandprocess_memory_used_bytesgauges are described but not populatedloadavgreturns zeros on Windows (platform limitation)imageboards/*.ts,custom_bot/client/*.tsare reference data only — not compiled, not read at runtime
en_US • /tay·vaks/ — Tei (Teyvat, Genshin reference; reflects the project's primary data source) + Ax (shorthand for Axum, the Rust web framework).
This tool can be freely copied, modified, altered, distributed without any attribution whatsoever. However, if you feel like this tool deserves an attribution, mention it. It won't hurt anybody.
Licence: WTF.