---
fragment_peers:
  agent-skill: agent-skill
  app-e-bancada-local-entre-participantes: local-app-and-participant-bench
  biblioteca-python: python-library
  codigo-e-configuracoes: code-and-configurations
  componentes-disponiveis: available-components
  core-rust-e-cli: rust-core-and-cli
  implementacoes-que-podem-surgir-dos-testes: implementations-that-can-emerge-from-tests
  percurso-git-e-openssh: git-and-openssh-workflow
  publicar-e-manter-um-componente: publish-and-maintain-a-component
  repositorios-do-projeto: project-repositories
  servidor-mcp-de-referencia: reference-mcp-server
lang: pt
peer: en/implementations/
shared_fragments: false
title: Código e configurações
---

# Código e configurações

Embora os formatos tornem possível o intercâmbio, são as ferramentas que
determinam quanto trabalho ele exige. Esta área reúne código e configurações
para facilitar a participação e crescerá com as necessidades encontradas nos
testes, desde uma busca local ou uma troca de arquivos mais simples até uma
composição adequada ao ambiente de uma empresa.

Cada componente deve resolver um problema concreto de participação, identificando
as operações que facilita e os requisitos para usá-lo. Para começar com um
rascunho, siga o [primeiro uso com IA](first-draft.md); os recursos abaixo
servem a quem deseja configurar ou programar outras operações.

O percurso de referência é [operar em Open Legibility](operate.md): ler questões
e propostas, formular, preservar, apresentar e continuar uma contribuição.
Uma configuração deve explicar quais dessas etapas facilita e quais continuam
manuais. Interfaces de repositório, modelos e indexação podem ser fornecidos
por ferramentas diferentes. O MCP existente não é um leitor automático de PRs.

Um agente com acesso autorizado a arquivos e Git pode começar sem MCP.
O [exemplo de espaço](downloads/legible-space-example-pt.zip) demonstra uma
coleção de pacotes escolhidos, separada do cache privado. O MCP é uma opção
para operações locais delimitadas, não uma exigência de uso do protocolo.

## Componentes disponíveis

Cada entrada informa a edição, os requisitos e os testes existentes.
Os guias acompanham o código desta distribuição, que pode ser consultado
antes de qualquer instalação.

### Core Rust e CLI

Preparar e verificar registros, ler rascunhos e consultar uma projeção local da genealogia.

**Experimental** · The Legible Protocol draft 0.4

**Requisitos:** Rust/Cargo; OpenSSH nos percursos de assinatura.

**Limites:** Os testes locais cobrem operações específicas; não certificam todas as condições da especificação.

[Guia e fontes](downloads/components/core.md) · [Código](https://github.com/LegibleProtocol/protocolDev/tree/main/reference/legible-core) · [Contribuir para este componente](contribute.md)

**Testes existentes:** `protocol/reference/legible-core/tests`.

### Biblioteca Python

Importar, buscar e exportar rascunhos, além de usar operações do core em programas Python.

**Experimental** · The Legible Protocol draft 0.4

**Requisitos:** Python e CLI Rust compilado; configuração explícita dos recursos opcionais.

**Limites:** Helpers de assinatura e de provedores precisam respeitar as autorizações de cada implantação.

[Guia e fontes](downloads/components/python.md) · [Código](https://github.com/LegibleProtocol/protocolDev/tree/main/reference/legible-py) · [Contribuir para este componente](contribute.md)

**Testes existentes:** `protocol/reference/legible-py/tests`.

### Servidor MCP de referência

Permitir que um cliente MCP busque, leia, importe e prepare contribuições locais, sem assiná-las.

**Experimental** · The Legible Protocol draft 0.4

**Requisitos:** Python, CLI Rust e host MCP compatível; HTTP exige a bancada configurada.

**Limites:** Não oferece assinatura por tool nem modelo embutido. Compatibilidade com contas e clientes externos requer teste no ambiente real.

[Guia e fontes](downloads/components/mcp.md) · [Código](https://github.com/LegibleProtocol/protocolDev/tree/main/reference/legible-mcp) · [Contribuir para este componente](contribute.md)

**Testes existentes:** `protocol/reference/legible-mcp/tests`.

### Percurso Git e OpenSSH

Exercitar a formalização local com ferramentas de linha de comando.

**Experimental** · The Legible Protocol draft 0.4

**Requisitos:** Git, OpenSSH e CLI Rust; a pessoa revisa e opera a assinatura.

**Limites:** Ed25519 simples é a linha de base. Os exemplos automatizados usam identidades fictícias.

[Guia e fontes](downloads/components/git-native.md) · [Código](https://github.com/LegibleProtocol/protocolDev/tree/main/adapters/git-native) · [Contribuir para este componente](contribute.md)

**Testes existentes:** `protocol/conformance/demos/demo_f_human_signs.sh`.

### Agent Skill

Orientar a preparação e a leitura de contribuições em ambientes que aceitam skills.

**Disponível** · The Legible Protocol draft 0.4

**Requisitos:** Ambiente capaz de carregar instruções; ferramentas e permissões são configuradas separadamente.

**Limites:** O pacote é documental. A resposta de cada modelo precisa ser avaliada no uso.

[Guia e fontes](downloads/components/skill.md) · [Código](https://github.com/LegibleProtocol/protocolDev/tree/main/skills/legible) · [Contribuir para este componente](contribute.md)

A avaliação do comportamento do modelo depende do ambiente de uso.

### App e bancada local entre participantes

Experimentar o circuito de rascunhos e preparação formal com escopos separados por participante.

**Experimental** · The Legible Protocol draft 0.4

**Requisitos:** Python, CLI Rust e, para a bancada Wi-Fi, OpenSSL e confiança HTTPS nos dispositivos.

**Limites:** É uma prova de conceito executada pelos participantes. A conexão nativa Gemini–MCP local permanece não verificada.

[Guia e fontes](downloads/components/local-app.md) · [Código](https://github.com/LegibleProtocol/protocolDev/tree/main/adapters/legible-app) · [Contribuir para este componente](contribute.md)

**Testes existentes:** `protocol/adapters/legible-app/test_app.py`.

## Implementações que podem surgir dos testes

Estas são frentes de desenvolvimento, ainda não componentes prontos:

- **Configuração para Hermes ou outro ambiente de agentes.** Uma receita deve
  informar a versão do host, como carregar instruções, quais ferramentas serão
  acessíveis e como diagnosticar falhas. Ter um servidor MCP não basta para
  afirmar compatibilidade com o host.
- **Indexador local independente.** Pode recuperar contribuições em pastas
  autorizadas e reconstruir seu índice a partir dos originais. Deve preservar
  origem e relações e distinguir rascunhos de registros formais. Busca por texto
  e inferência com modelo precisam ser identificadas separadamente. O core já
  oferece projeção e consulta; aproveite essas operações antes de duplicá-las.
- **Ambiente corporativo de referência.** Pode combinar identidades, acesso
  às evidências, armazenamento interno e processamento local ou externo
  autorizado. A receita precisa documentar a composição e os testes de isolamento.

Uma necessidade pequena pode justificar uma configuração de poucas linhas.
O tamanho da implementação deve acompanhar o problema encontrado no uso.

## Publicar e manter um componente

Os códigos podem ficar em repositórios da organização LegibleProtocol no GitHub,
quando estabelecida, ou em repositórios de mantenedores independentes.
Uma receita pode compartilhar um repositório com outras configurações;
uma ferramenta com dependências e evolução próprias pode ter o seu.

Para propor um componente, apresente o problema que resolve, a licença,
a instalação e um exemplo reproduzível. Identifique a edição do protocolo,
as versões testadas e quem o mantém. Explique também onde ficam os dados,
quais passos cada participante precisa repetir e quem fornece o modelo
se houver inferência.

Os mantenedores selecionam as entradas e atualizam o site estático.
Distribuir esse código não exige operar as instalações dos usuários.
O catálogo descreve capacidades e testes; a especificação define conformidade.

Um teste técnico mostra se uma operação funciona. Um relato de colaboração
ajuda a entender se ela merece ser usada. Ambos podem orientar melhorias.
Appoints e relações podem acompanhar o componente quando seus autores
escolherem prepará-los e compartilhá-los; uma alteração de código não exige
um registro próprio.

[Contratos técnicos](implementation.md) ·
[Executar localmente e conectar MCP](configurations.md) · [Contribuir](contribute.md)

## Repositórios do projeto

[Organização no GitHub](https://github.com/LegibleProtocol) · [Repositório do protocolo — acesso por convite](https://github.com/LegibleProtocol/protocolDev) · [Repositório do site — acesso por convite](https://github.com/LegibleProtocol/websiteDev) · [Livros e artigos no GitHub — acesso por convite](https://github.com/LegibleProtocol/publicationsDev) · [Contato](mailto:contact@legibleprotocol.com)