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.