From zero to your first briefing

5 steps. About 30 minutes. No programming required.

scroll
Detected: --
New to this? This guide uses a terminal — a text window for commands.
Windows: Win+R then cmd. macOS: Cmd+Space then Terminal. Linux: Ctrl+Alt+T.
Every dark code block = copy and paste into that window. Primeira vez? Este guia usa um terminal — uma janela de texto para comandos.
Windows: Win+R e digite cmd. macOS: Cmd+Space e digite Terminal. Linux: Ctrl+Alt+T.
Todo bloco escuro = copiar e colar nessa janela.
1
Install prerequisites
~5 min

Three tools: Python (Vera's language), Git (download code), uv (manage dependencies).

Três ferramentas: Python (linguagem da Vera), Git (baixar código), uv (gerenciar dependências).

Python 3.11+

Download from python.org/downloads. Check "Add Python to PATH".

Baixe em python.org/downloads. Marque "Add Python to PATH".

brew install python
sudo apt install python3 python3-pip

Git

Download from git-scm.com, install with defaults.

Baixe em git-scm.com, instale com padrões.

brew install git
sudo apt install git

uv

Open PowerShell (not cmd):

Abra o PowerShell (não o cmd):

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
curl -LsSf https://astral.sh/uv | sh
curl -LsSf https://astral.sh/uv | sh

Verify

Close and reopen terminal, then:

Feche e reabra o terminal:

python --version
git --version
uv --version
Version numbers for all three. Python must be 3.11+. Números de versão nos três. Python deve ser 3.11+.

"python" not recognized (Windows): reopen terminal. If broken, reinstall with "Add to PATH".

"python" não reconhecido (Windows): reabra o terminal. Se não funcionar, reinstale com "Add to PATH".

No Homebrew (macOS): brew.sh first.

Sem Homebrew (macOS): instale via brew.sh primeiro.

Linux: try python3 --version.

Linux: tente python3 --version.

2
Get the code
~5 min

1. Fork

Open github.com/veralifeos/vera-open, click Fork, then Create fork.

Abra github.com/veralifeos/vera-open, clique em Fork, depois Create fork.

Need a free GitHub account. Precisa de uma conta gratuita no GitHub.

2. Clone

Replace YOUR_USERNAME:

Substitua YOUR_USERNAME:

git clone https://github.com/YOUR_USERNAME/vera-open.git
cd vera-open
uv sync
uv sync finishes without errors = ready. uv sync termina sem erros = pronto.

Fork = your copy on GitHub.
Clone = download to your machine.
uv sync = install project dependencies.

Fork = sua cópia no GitHub.
Clone = baixar para sua máquina.
uv sync = instalar dependências.

3
Get your credentials
~15 min

Tokens = passwords that let Vera access each service.

Tokens = senhas que permitem a Vera acessar cada serviço.

A. Notion

  1. notion.so → Settings → Connections → "Develop or manage integrations"
  2. New integration → name "Vera" → Internal → Read + Insert + Update → Save
  3. Copy token (ntn_ or secret_)
  1. notion.so → Settings → Connections → "Develop or manage integrations"
  2. Nova integração → nome "Vera" → Internal → Read + Insert + Update → Save
  3. Copie o token (ntn_ ou secret_)

Duplicate template: Vera template

Duplique o template: Vera template

Connect integration to EACH database: open it → ••• → Connections → "Vera"

Conecte a integração em CADA database: abra → ••• → Connections → "Vera"

Connect on each database, not the parent page. #1 mistake. Conecte em cada database, não na página pai. Erro nº 1.

B. Telegram

  1. @BotFather → /newbot → name + username → copy token
  2. Send any message to your bot
  3. Open in browser:
  1. @BotFather → /newbot → nome + username → copie o token
  2. Envie qualquer mensagem pro seu bot
  3. Abra no navegador:
https://api.telegram.org/botYOUR_TOKEN/getUpdates

Find "chat":{"id": 123456789} = your Chat ID.

Procure "chat":{"id": 123456789} = seu Chat ID.

Send a message to the bot first, reload. Wait 10s if still empty.

Envie uma mensagem pro bot primeiro, recarregue. Espere 10s se ainda vazio.

C. Claude API

  1. console.anthropic.com → create account (free US$5)
  2. API Keys → Create Key → copy (sk-ant-api03-)
  1. console.anthropic.com → crie uma conta (US$5 grátis)
  2. API Keys → Create Key → copie (sk-ant-api03-)
US$5 lasts months (~$0.01-0.03/day). US$5 dura meses (~$0.01-0.03/dia).
4
Configure and validate
~5 min
uv run vera setup

Paste each credential when prompted.

Cole cada credencial quando solicitado.

Test connections

uv run vera validate

If something fails

uv run vera doctor
10 checks. All [OK] = ready. [FAIL] tells you what to fix. 10 verificações. Tudo [OK] = pronto. [FAIL] diz o que corrigir.

"No module named vera" → uv sync first.

"No module named vera" → rode uv sync primeiro.

Notion not found → connect integration to each database (step 3A).

Notion não encontrado → conecte a integração em cada database (passo 3A).

Telegram fails → CHAT_ID must be numeric, not username.

Telegram falha → CHAT_ID deve ser numérico, não username.

5
Your first briefing
~2 min

Test (nothing sent)

uv run vera briefing --dry-run --force
Briefing text in terminal = working. Texto do briefing no terminal = funcionando.

Send for real

uv run vera briefing --force

Check Telegram. That's your first briefing.

Confira no Telegram. Esse é seu primeiro briefing.

Next

  • Personalize: edit workspace/USER.md
  • Personalize: edite workspace/USER.md
  • Research: uv run vera packs install jobs
  • Research: uv run vera packs install jobs
  • Automate: GitHub Actions (below)
  • Automatize: GitHub Actions (abaixo)
  • Explore: uv run vera --help
  • Explore: uv run vera --help

Your fork → Settings → Secrets and variables → Actions. Add 4 secrets:

Seu fork → Settings → Secrets and variables → Actions. Adicione 4 secrets:

NOTION_TOKEN
ANTHROPIC_API_KEY
TELEGRAM_BOT_TOKEN
TELEGRAM_CHAT_ID

Actions tab → "Vera Briefing" → Enable workflow.

Aba Actions → "Vera Briefing" → Enable workflow.

Vera runs every weekday. Sat = retrospective, Sun = planning. Vera roda todo dia útil. Sáb = retrospectiva, Dom = planejamento.
Vera Stuck? Ask the Assistant