Repolode
Enviar
ollama

ollama/ollama-python

Biblioteca cliente oficial de Python para acessar modelos locais e na nuvem do Ollama pelas APIs de chat, geração, embeddings e gerenciamento de modelos.

Ver no GitHubSite
Estrelas
10,611
Forks
1,209
Issues abertas
223
Último commit
há 4 dias

O que é?

A biblioteca Ollama para Python é um cliente para a API REST do Ollama, que permite que projetos com Python 3.8+ se comuniquem com modelos servidos por uma instância do Ollama em execução. Ela reúne chamadas de chat, geração, embeddings, listagem, download, envio, cópia, exclusão e status de processos em um pequeno conjunto de funções, com clientes síncronos e assíncronos equivalentes.

As respostas podem ser retornadas por inteiro ou transmitidas em partes, e o mesmo cliente pode se conectar a um servidor local do Ollama ou à API hospedada na nuvem em ollama.com usando uma API key. Modelos na nuvem, como gpt-oss:120b-cloud, podem ser executados pelo servidor local após o login ou chamados diretamente. Erros decorrentes de respostas HTTP malsucedidas ou ocorridos durante a transmissão são lançados como ResponseError.

A biblioteca também inclui uma API System One para decisões estruturadas, como escolher entre várias opções, atribuir uma pontuação em uma escala ou retornar uma probabilidade de sim/não, usando modelos de decisão como nimble e clef.

Recursos principais

  • 01Chamadas de chat, geração e embeddings que refletem a API REST do Ollama.
  • 02Respostas em streaming com stream=True, tanto nos modos síncrono quanto assíncrono.
  • 03Classes Client e AsyncClient que aceitam um host personalizado e cabeçalhos httpx.
  • 04Funções de gerenciamento de modelos para listar, mostrar, criar, baixar, enviar, copiar e excluir.
  • 05Acesso a modelos na nuvem pelo servidor local ou diretamente em ollama.com com uma API key.
  • 06API System One para decisões estruturadas, com suporte a perguntas de escolha, sim/não e pontuação.

Casos de uso

  • Adicionar um recurso de chat com LLM local a um app web ou script em Python.
  • Gerar embeddings de texto para pipelines de busca ou recuperação de informações.
  • Alternar entre modelos locais e modelos hospedados na nuvem usando o mesmo código.
  • Criar etapas automatizadas de triagem ou classificação com perguntas de decisão estruturadas.

Início rápido

  1. 1

    Instale o Ollama e verifique se ele está em execução

  2. 2

    Baixe um modelo para usar com a biblioteca

    ollama pull gemma4
  3. 3

    Instale a biblioteca Python

    pip install ollama
  4. 4

    Chame a API de chat pelo Python

Antes de usar

  • É necessário ter um servidor Ollama instalado e em execução localmente ou uma chave de API do Ollama para modelos na nuvem.
  • Para usar modelos na nuvem, é necessária uma conta do Ollama, e o acesso à API na nuvem pode exigir um plano pago.

Tópicos

#llm#python-client#ollama#chat-api#embeddings#streaming#async#python

Perguntas frequentes

O que é ollama-python?
Biblioteca cliente oficial de Python para acessar modelos locais e na nuvem do Ollama pelas APIs de chat, geração, embeddings e gerenciamento de modelos. A biblioteca Ollama para Python é um cliente para a API REST do Ollama, que permite que projetos com Python 3.8+ se comuniquem com modelos servidos por uma instância do Ollama em execução. Ela reúne chamadas de chat, geração, embeddings, listagem, download, envio, cópia, exclusão e status de processos em um pequeno conjunto de funções, com clientes síncronos e assíncronos equivalentes.
ollama-python é gratuito? Qual é a licença?
ollama-python é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
ollama-python ainda é mantido?
Manutenção ativa. O último commit de ollama-python foi em 16 de out. de 2026.
Para que posso usar ollama-python?
Adicionar um recurso de chat com LLM local a um app web ou script em Python. Gerar embeddings de texto para pipelines de busca ou recuperação de informações. Alternar entre modelos locais e modelos hospedados na nuvem usando o mesmo código. Criar etapas automatizadas de triagem ou classificação com perguntas de decisão estruturadas.
Como instalar ollama-python?
Instale o Ollama e verifique se ele está em execução Baixe um modelo para usar com a biblioteca: ollama pull gemma4 Instale a biblioteca Python: pip install ollama Chame a API de chat pelo Python
Onde consigo ollama-python?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ollama/ollama-python

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados