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:
-| Distribuição | Comando |
|---|---|
| Arch Linux | sudo pacman -S sqlite |
| Debian / Ubuntu | sudo apt install libsqlite3-dev |
| Fedora | sudo dnf install sqlite-devel |
| Alpine | apk add sqlite-dev |
| macOS (Homebrew) | brew install sqlite |
| FreeBSD | pkg install sqlite3 |
| OpenBSD | Já incluído no sistema base |
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
-| Ferramenta | Para quê | Instalação |
|---|---|---|
| just | Executar comandos de build do projeto | cargo install just |
| mdBook | Compilar a documentação | cargo install mdbook |
| Docker | Executar nós em contêineres | Veja Docker |
| Flutter | Compilar o app mobile/desktop | Veja App Flutter |
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
--
-
- Flutter SDK — instale seguindo o guia oficial -
- Rust — já instalado conforme acima -
- Dependências de plataforma: -
| Plataforma | Dependências |
|---|---|
| Android | Android SDK, Android NDK, Java 17+ |
| iOS | Xcode, CocoaPods |
| Linux desktop | GTK 3.0+, pkg-config (sudo apt install libgtk-3-dev pkg-config no Debian/Ubuntu) |
| macOS desktop | Xcode Command Line Tools |
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:
-| Protocolo | Porta | Direção |
|---|---|---|
| UDP | 4433 | Entrada e saída |
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 -