Seline
Blog
Documentation

Getting started

Everything you need to go from a fresh account to a working, always-on personal agent. Read top to bottom, or jump to the part you need.

Quickstart

Five short steps and you'll be chatting with your agent on Telegram.

  1. 1

    Sign up with your invite

    Seline is invite-only during the preview. Enter your invite code (or open your invite link) and create your account with email or Google.

  2. 2

    Follow the onboarding

    Right after signing up, a short guided flow walks you through the two things your agent needs: a way to reach it and a model to run it.

  3. 3

    Connect Telegram

    Create a bot with @BotFather, paste its token, and add your Telegram username to the allowlist so only you can message your agent.

  4. 4

    Add a model provider key

    Pick a provider (OpenRouter is the default) and paste its API key. This is what powers your agent’s thinking.

  5. 5

    Start your agent and say hi

    Finish onboarding to start your agent, then open Telegram and message it. Try “What can you do?” to see it in action.

Core concepts

A quick mental model for how Seline is put together. You never touch the internals — this just helps things make sense.

Your agent

The always-on assistant you chat with on Telegram. You manage it from the dashboard — start it, configure it, watch its status — and it works for you in the background.

Container

Your agent runs in its own isolated space. Your encrypted secrets and memory live there and are never shared with anyone else.

Session

A running conversation with context. Your agent remembers what you’ve been talking about within a session so you don’t have to repeat yourself.

Commitment

A promise your agent has made to do something — a reminder, a recurring task, a thing to watch. Commitments are what make it feel proactive rather than just reactive.

Checkpoint

A saved point in your agent’s memory. Older history is compacted into checkpoints so the agent stays fast and relevant while keeping the gist of what came before.

Secret

A sensitive value like an API key or bot token. Secrets are stored encrypted and used by your agent when it runs — only masked previews are ever shown back to you.

Connecting integrations

Two things power your agent: a way to talk to it (Telegram) and a brain to run it (a model provider). Here’s how to wire up both.

Linking a Telegram bot

  1. 1

    Talk to @BotFather

    Open Telegram, search for @BotFather, send /newbot, and follow the prompts to name your bot.

  2. 2

    Copy the bot token

    BotFather gives you a token that looks like 123456789:ABC… Paste it into TELEGRAM_BOT_TOKEN on the Secrets page.

  3. 3

    Set your allowlist

    Add your Telegram username (with the @) to TELEGRAM_ALLOWLIST. Only listed usernames can message the agent — separate multiple with commas.

Adding a model provider key

  1. 1

    Pick a provider

    Seline supports OpenRouter, Sarvam, NVIDIA, and Cerebras. OpenRouter is the default and gives you access to many models with one key.

  2. 2

    Generate an API key

    Create a key in your provider’s dashboard, then paste it into the matching field on the Secrets page (e.g. OPENROUTER_API_KEY).

  3. 3

    Save — it’s encrypted

    Your key is stored encrypted in your container and never shown in plain text again. You can rotate it anytime.

Writing good instructions

Your agent understands plain language, but clear instructions get better results — especially for recurring tasks and reminders.

  • Be specific about timing: “every Monday at 9am” beats “weekly”.
  • Say what you want to happen and when to stop — “until I tell you otherwise”.
  • Ask it to confirm before anything irreversible: sending, deleting, or paying.
  • Give it a source to watch and a signal to act on: “alert me if the status changes”.
  • Tell it how you want to be reached — a Telegram message, a summary, a nudge.
Example

“Every weekday at 8am, check my calendar and text me a summary of the day. If a meeting gets cancelled, let me know right away. Don’t send anything to other people without asking me first.”

Good to know: Your agent won’t take destructive or outward-facing actions without your confirmation. You can always be explicit about permissions — it’s designed to ask when in doubt.

Troubleshooting

The quick fixes for the things that most commonly go sideways.

My agent isn’t responding on Telegram+

Check that your agent container is running from the dashboard, confirm the bot token is correct, and make sure your username is on the allowlist. If it’s still quiet, restart the container.

The container keeps restarting+

This usually means a required secret is missing or invalid — most often the model provider API key. Open the Secrets page, re-check the values, and start the agent again.

Secret validation is failing+

Make sure you copied the full value with no leading or trailing spaces. Bot tokens include a colon; API keys are provider-specific. Re-paste the value and save.

My agent forgot something we talked about+

Older conversation is compacted into checkpoints to stay fast. If you need it to remember something long-term, tell it explicitly — “remember that…” — so it keeps it front of mind.

Ready to spin one up?

Create your account and Seline will walk you through the whole setup.

Go to your dashboard