Instalação

Tesseras está disponível atualmente através de compilação a partir do código-fonte.

Pré-requisitos

Rust

Tesseras requer Rust 1.85 ou superior. A maneira recomendada de instalar o Rust é via rustup:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Após a instalação, certifique-se de que ~/.cargo/bin está no seu PATH. O instalador normalmente adiciona isso automaticamente. Verifique com:

rustc --version
cargo --version

Se você já tem o Rust instalado, atualize para a versão mais recente:

rustup update stable

SQLite

Tesseras usa SQLite para armazenamento local. Você tem duas opções:

Opção 1: SQLite do sistema (recomendada)

Instale as bibliotecas de desenvolvimento do SQLite pelo gerenciador de pacotes do seu sistema:

Opção 2: SQLite embutido

Se preferir não instalar o SQLite no sistema, use a feature flag bundled-sqlite durante a compilação. Isso compila o SQLite junto com o Tesseras:

cargo install --path crates/tesseras-cli --features bundled-sqlite
cargo install --path crates/tesseras-daemon --features bundled-sqlite

Ferramentas opcionais

Compilar a partir do código-fonte

Clone o repositório e instale os binários:

git clone https://git.sr.ht/~ijanc/tesseras
cd tesseras
cargo install --path crates/tesseras-cli
cargo install --path crates/tesseras-daemon

Ou, se você tiver o just instalado:

just install

Isso instala dois binários em ~/.cargo/bin/ e configura auto-completions para o seu shell:

• tes — ferramenta CLI para criar, verificar e exportar tesseras
• tesseras-daemon — daemon de nó completo que participa da rede P2P

Verificar a instalação

tes --help

Você deverá ver:

Create and preserve human memories

Usage: tes [OPTIONS] <COMMAND>

Commands:
  init    Initialize identity and local database
  create  Create a tessera from a directory of files
  verify  Verify integrity of a stored tessera
  export  Export tessera to a self-contained directory
  list    List local tesseras
  help    Print this message or the help of the given subcommand(s)

Options:
      --data-dir <DATA_DIR>  Base directory for data storage [default: ~/.tesseras]
  -h, --help                 Print help

Auto-completions do shell

O comando just install configura completions automaticamente. Se você instalou manualmente, gere as completions para o seu shell:

# Fish
tes completions fish > ~/.config/fish/completions/tes.fish

# Zsh
tes completions zsh > "${XDG_DATA_HOME:-$HOME/.local/share}/zsh/site-functions/_tes"

# Bash
tes completions bash > "${XDG_DATA_HOME:-$HOME/.local/share}/bash-completion/completions/tes"

App Flutter

Para compilar o app mobile ou desktop, você precisa de dependências adicionais:

Pré-requisitos do Flutter

1. Flutter SDK — instale seguindo o guia oficial
2. Rust — já instalado conforme acima
3. Dependências de plataforma:

Compilar o app

cd apps/flutter
flutter pub get

# Linux desktop
flutter build linux --debug

# Android
flutter build apk --debug

# iOS
flutter build ios --debug

# Testes
flutter test

Ou usando just a partir da raiz do repositório:

just build-linux    # Linux desktop
just build-android  # Android APK
just test-flutter   # Testes

Portas de rede

O daemon Tesseras usa QUIC (protocolo sobre UDP). Se você estiver atrás de um firewall, permita tráfego na porta:

Próximos passos

• Início Rápido — crie sua primeira tessera
• Executando um Nó — configure e execute o daemon
• Configuração — opções de configuração
• Docker — execute em contêineres