Implantação do Koha: guia completo, do diagnóstico à entrada em produção

O Koha em poucas palavras

O Koha é um sistema integrado de gestão de bibliotecas (SIGB, ou ILS em inglês) de código aberto, usado por milhares de bibliotecas no mundo. Foi o primeiro SIGB livre e hoje é uma das plataformas mais maduras do setor, 100% web, com os módulos que uma biblioteca usa no dia a dia:

• Catalogação em MARC21 ou UNIMARC, com autoridades e catalogação cooperativa via Z39.50 e SRU.
• Circulação: empréstimos, devoluções, renovações, reservas e multas, com regras configuráveis por categoria de usuário.
• OPAC: catálogo público on-line, responsivo e personalizável com a identidade visual da instituição.
• Aquisições: compras, orçamentos e fornecedores.
• Periódicos, relatórios e estatísticas de uso.

Se você ainda está avaliando a plataforma, comece por o que é Koha, que conta a origem, a arquitetura e quem mantém o projeto.

O que se contrata em uma implantação do Koha

Como o Koha não tem custo de licença, a proposta de um fornecedor cobre serviços. Uma implantação completa normalmente inclui:

• Instalação em servidor da instituição ou em hospedagem gerenciada na nuvem.
• Configuração de todos os módulos e das políticas de circulação.
• Migração de registros bibliográficos, exemplares, usuários, empréstimos ativos, reservas e multas.
• Relatório de qualidade dos dados e limpeza antes da carga definitiva.
• Personalização do OPAC com a identidade visual da instituição.
• Autenticação via LDAP, Active Directory ou sistema acadêmico.
• Treinamento por função, com manuais e gravações.
• Suporte anual com atualizações de versão planejadas.

Na BiblioLabTech, a proposta é montada pelo escopo do projeto, não pelo número de usuários nem pelo tamanho do catálogo, e todo projeto de Koha inclui o BiblioScan AI, de catalogação assistida por IA, sem custo adicional. A hospedagem aparece como uma linha separada, em duas versões, com e sem hospedagem, porque muitas instituições já têm infraestrutura própria.

As etapas da implantação do Koha

A implantação do Koha segue uma sequência em que cada fase depende da anterior. Pular etapas, especialmente a validação dos dados, é o que transforma um projeto de meses em um projeto de semestres.

1. Diagnóstico

Revisão do acervo, dos dados atuais e dos fluxos de trabalho da biblioteca: sistema de origem e versão, volume de registros, exemplares e usuários, qualidade dos dados, regras de circulação, unidades e integrações necessárias. O resultado é um escopo escrito, com cronograma e custo.

2. Instalação e configuração

O Koha é instalado na infraestrutura combinada e configurado em torno das políticas reais da biblioteca: frameworks MARC, tipos de item, códigos de coleção, regras de circulação e de multas, categorias de usuário, permissões da equipe, avisos e OPAC. Bibliotecas com várias unidades podem operar todas em uma única instância, com regras compartilhadas ou separadas. Essa parametrização não é migrada, e sim reconstruída: em uma rede com três unidades, ela pode levar tanto tempo quanto a carga de dados.

3. Migração de dados

Os dados são extraídos do sistema atual, mapeados campo a campo para MARC21, limpos e carregados em ciclos de teste até que a biblioteca aprove contagens e amostras. Antes da carga final, a BiblioLabTech entrega um relatório de qualidade com duplicados, campos obrigatórios vazios, autoridades inconsistentes e codificações de caracteres corrompidas; a biblioteca decide o que é corrigido automaticamente, o que é revisado à mão e o que entra como está para revisão posterior. O processo completo está em migração para o Koha.

4. Personalização do OPAC

O catálogo público recebe a identidade visual da instituição e deve ser publicado em um subdomínio próprio, não no domínio do fornecedor, para que o endereço sobreviva a qualquer troca de prestador. Aplicar a identidade visual é simples; redesenhar a experiência de busca é um projeto de desenvolvimento à parte, que pode ficar para uma segunda fase.

5. Treinamento por função

Em vez de uma sessão geral, cada equipe aprende o trabalho que de fato faz: processos técnicos (catalogação, autoridades, análise de assunto), circulação e atendimento ao público, aquisições e periódicos, e administração do sistema para a TI. O treinamento acontece na própria instância da biblioteca, com o seu catálogo, e as sessões são gravadas e acompanhadas de manuais.

6. Entrada em produção e suporte

A virada acontece em uma janela combinada, depois de congelar o sistema anterior. As primeiras semanas são acompanhadas de perto e, em seguida, a biblioteca passa ao suporte anual, com atendimento de incidentes e atualizações de versão planejadas.

Quanto tempo leva a implantação do Koha

Os prazos abaixo valem para projetos com exportação disponível em formato padrão e com a equipe da biblioteca participando da validação.

A variável que mais pesa não é o número de registros, e sim o número de unidades: cada campus acrescenta parametrização, regras de circulação, usuários e validação próprios. Depois vem a qualidade dos dados de origem: um catálogo MARC21 limpo migra muito mais rápido do que um formato proprietário com registros sem padronização. Uma biblioteca pequena, com dados limpos, pode estar operando em poucas semanas.

Integrações com os sistemas da instituição

O Koha fala os protocolos padrão do setor, o que torna as integrações previsíveis:

• Z39.50 e SRU para busca federada e catalogação por cópia.
• SIP2 para máquinas de autoempréstimo e portais antifurto.
• OAI-PMH para coleta de metadados.
• ILS-DI e API REST para integrações próprias.
• LDAP, Active Directory, CAS, SAML e OpenID Connect para autenticação com o diretório institucional, sem um segundo conjunto de senhas.

A sincronização de usuários com o sistema acadêmico é feita por autenticação externa ou por cargas programadas. Cada integração adicional entra no escopo e no orçamento; o detalhamento de custos por componente está em quanto custa implantar o Koha.

Onde o Koha vai rodar

O Koha roda em Linux com componentes de código aberto, então também não há licenças de sistema operacional nem de banco de dados. Há dois modelos: o servidor da instituição, entregue documentado e com backups e monitoramento configurados, ou a hospedagem gerenciada pela BiblioLabTech, com backups diários, HTTPS, monitoramento de disponibilidade e atualizações de segurança. Existe ainda um meio-termo: o servidor é da instituição e a administração do Koha é feita remotamente pelo fornecedor. A comparação completa, com requisitos de CPU e memória por tamanho de acervo, está em hospedagem Koha.

Dados pessoais e LGPD na configuração

O Koha guarda dados pessoais dos usuários e o histórico de empréstimos, por isso a configuração inicial deve refletir a política de privacidade da instituição. O sistema permite anonimizar automaticamente o histórico de empréstimos após um prazo definido, criar perfis de equipe com permissões granulares e manter registro de auditoria das operações. No Brasil, esses recursos ajudam a instituição a aplicar as regras da Lei Geral de Proteção de Dados Pessoais (LGPD, Lei nº 13.709/2018); em outros países, a lógica é a mesma diante da legislação local. Os dados ficam na infraestrutura que a instituição definir.

Catalogação com IA incluída

Toda implantação de Koha feita pela BiblioLabTech inclui o BiblioScan AI sem custo adicional. O catalogador fotografa a capa, a folha de rosto e o sumário; o BiblioScan AI lê as imagens e preenche um rascunho de registro MARC21 dentro do Koha. O catalogador revisa, corrige e salva, de modo que o controle bibliográfico continua humano e a transcrição repetitiva desaparece. Para bibliotecas com material acumulado à espera de catalogação, isso muda a conta do projeto. O passo a passo está em catalogação com inteligência artificial.

Erros que atrasam a implantação

• Parametrização incompleta: categorias de usuário ou regras de empréstimo que não foram replicadas e aparecem no primeiro dia de aula.
• Codificação de caracteres mal declarada: acentos e cedilhas corrompidos depois da carga, quando o problema não é detectado no lote piloto.
• Códigos de barras repetidos ou inexistentes: o Koha exige códigos únicos; se o acervo nunca teve código de barras, é preciso gerar, imprimir e colar etiquetas, um projeto em si.
• Não congelar o sistema anterior e acabar com dois catálogos divergentes durante semanas.
• Subestimar o treinamento: um SIGB novo com uma equipe que não domina relatórios e regras de circulação acaba subutilizado.
• Não perguntar como serão as atualizações: alguns fornecedores cobram cada atualização à parte, o que no médio prazo pode custar mais que o projeto inicial.

Quem implanta o Koha

Não existe fornecedor oficial do Koha: a própria comunidade avisa que nenhuma organização pode se apresentar assim, e que aparecer no diretório de suporte pago do koha-community.org não dá status especial. O que vale avaliar é a experiência verificável com migrações, a capacidade de resposta a incidentes em produção e se o fornecedor contribui de volta com a comunidade.

A BiblioLabTech, empresa de tecnologia e inteligência artificial para bibliotecas com sede em Medellín (Colômbia), executa projetos de Koha de ponta a ponta: implantação, migração, hospedagem, suporte e atualizações, com uma única equipe do primeiro diagnóstico à última atualização. A Escuela Colombiana de Ingeniería Julio Garavito opera seu catálogo Koha com catalogação assistida pelo BiblioScan AI, ao lado de um repositório DSpace, do metabuscador BiblioMeta e de um chatbot de referência, tudo em um servidor dedicado administrado pela BiblioLabTech (leia o caso).

A equipe trabalha de forma remota com instituições de qualquer país, com atendimento em português, no fuso UTC−5, duas horas a menos que Brasília. Conheça o serviço de implantação do Koha ou fale com a equipe para receber uma proposta com escopo, prazo e custo.