yarno 0.3.0

write bots for we.yarno — cards, inline forms, server-counted polls, live values, voice

yarno

write bots for we.yarno — the invite-only servers/channels/voice app.

pip install yarno

the shortest complete bot:

from yarno import Bot

bot = Bot()                    # reads $YARNO_TOKEN

@bot.command("hi", "says hi")
async def hi(ctx):
    return f"hi {ctx.username}"

bot.run()

no intents, no command tree, no sync() step, no 3-second deadline. your bot holds a live socket to the instance, so the decorator is the registration and a handler can take as long as it needs.

what you get

• cards — compose rows, columns, progress bars, images, buttons instead of filling in an embed
• inline forms — ui.input / ui.select / ui.toggle / ui.slider live in the card, in the channel; any click submits the whole form as ctx.values. no modals.
• polls that outlive you — ui.button(collect="v:yes") is counted by the server, so votes land while your process is down; read them back with bot.tallies()
• live values — ui.ticker / ui.bar(rate=...) / ui.slider(rate=...) advance on every viewer's screen; you push state changes, not frames. a seek bar that tracks the playhead is one component.
• docked cards — pin one card above the channel's scroll (now playing, scoreboards, countdowns)
• autocomplete — suggest argument values as someone types, over your already-open socket
• dms, files, reactions, avatars, voice — @bot.on_message, send(files=[...]), bot.react(), bot.set_avatar(), and bot.voice_join() with the yarno[voice] extra — music-grade stereo opus, and play() takes seek / ffmpeg filters / auth headers and reports the audio it actually delivered, so a real dj bot is yt-dlp + ffmpeg away
• buttons that survive restarts — per-message state lives on the server and rides back with every click

privacy, stated up front

a bot sees nothing by default: commands aimed at it, clicks on its own cards, and dms it's part of. it does not receive channel messages, and there is no intent to flip on. the read apis hold the same line.

docs

• quickstart — token to working command in about two minutes
• cards & components
• the full sdk reference
• wire protocol — for writing a bot in another language

examples live in examples/: pingpong.py is the core loop, lunchbot.py is forms + polls + autocomplete + a docked countdown.

tokens come from the dev console. we.yarno is invite-only; the sdk is public so bots can be written for it.