Início Rápido
-Este tutorial guia você por um fluxo completo: criar uma identidade, construir uma tessera a partir de arquivos, verificá-la e exportá-la.
-1. Inicializar sua identidade
-Primeiro, configure sua identidade local e banco de dados:
-tes init
-Generated Ed25519 identity
-Database initialized
-Config written to /home/user/.tesseras/config.toml
-Tesseras initialized at /home/user/.tesseras
-Isso cria:
--
-
~/.tesseras/identity/— seu par de chaves Ed25519
-~/.tesseras/db/— banco de dados SQLite para indexação
-~/.tesseras/blobs/— armazenamento para arquivos de memória
-~/.tesseras/config.toml— arquivo de configuração
-
2. Preparar seus arquivos
-Crie um diretório com as memórias que deseja preservar:
-mkdir minhas-memorias
-cp ~/fotos/jantar-familia.jpg minhas-memorias/
-cp ~/fotos/jardim.jpg minhas-memorias/
-echo "Uma tarde quente de domingo com a família." > minhas-memorias/reflexao.txt
-Formatos suportados: .jpg, .jpeg, .png (imagens), .wav (áudio), .webm (vídeo), .txt (texto).
3. Pré-visualizar com dry run
-Veja o que seria incluído sem criar nada:
-tes create minhas-memorias --dry-run
-4. Criar uma tessera
-tes create minhas-memorias --tags "familia,domingo" --location "Casa"
-A saída inclui o hash de conteúdo — uma string hexadecimal de 64 caracteres que identifica unicamente sua tessera. Copie-o para os próximos passos.
-5. Listar suas tesseras
-tes list
-Hash Created Memories Size Visibility
-9f2c4a1b3e7d8f0c 2026-02-14 3 284 KB public
-6. Verificar integridade
-Use o hash de conteúdo para verificar que todos os arquivos estão intactos e a assinatura é válida:
-tes verify 9f2c4a1b3e7d8f0c...
-Tessera: 9f2c4a1b3e7d8f0c...
-Signature: VALID
- [OK] memories/a1b2c3/media.jpg
- [OK] memories/d4e5f6/media.jpg
- [OK] memories/g7h8i9/media.txt
-Verification: PASSED
-7. Exportar uma cópia autocontida
-Exporte a tessera para um diretório que pode ser lido sem o Tesseras:
-tes export 9f2c4a1b3e7d8f0c... ./backup
-Exported to ./backup/tessera-9f2c4a1b3e7d8f0c...
-8. Inspecionar a exportação
-O diretório exportado é totalmente autocontido:
-tessera-9f2c4a1b3e7d8f0c.../
-├── MANIFEST # Índice em texto puro com checksums
-├── README.decode # Como ler esta tessera sem software
-├── identity/
-│ ├── creator.pub.ed25519 # Sua chave pública
-│ └── signature.ed25519.sig # Assinatura do MANIFEST
-├── memories/
-│ ├── <hash>/
-│ │ ├── media.jpg # A foto
-│ │ ├── context.txt # Descrição em texto puro
-│ │ └── meta.json # Metadados estruturados
-│ └── .../
-└── decode/
- ├── formats.txt # Explicação de todos os formatos usados
- ├── jpeg.txt # Como decodificar JPEG
- └── json.txt # Como decodificar JSON
-Tudo que um leitor futuro precisa para entender o conteúdo está incluído no próprio diretório — nenhum software Tesseras é necessário.
- -