knowsuchagency/promptic

O que é?

Recursos principais

• 01Transforma docstrings de funções em templates de prompt por meio do decorator @llm.
• 02Valida saídas estruturadas com modelos Pydantic ou JSON Schema.
• 03Dá suporte a chamadas de ferramentas com funções registradas por meio de @llm.tool.
• 04Faz streaming das respostas e aceita entradas de imagem como ImageBytes.
• 05Oferece memória de conversa opcional com uma classe State personalizável.

Casos de uso

• Criar protótipos de funcionalidades com LLMs em Python sem escrever código repetitivo para as requisições.
• Extrair dados tipados de textos ou imagens e convertê-los em objetos Pydantic.
• Criar um chatbot ou agente simples que chama funções Python como ferramentas.
• Alternar entre provedores de LLM sem reescrever o código da aplicação.

Início rápido

1. 1

   Instale promptic pelo PyPI

   pip install promptic
2. 2

   Defina a chave de API do seu provedor de LLM como uma variável de ambiente (exemplo para OpenAI)

   export OPENAI_API_KEY=sk-...
3. 3

   Decore uma função com @llm, usando a docstring como prompt, e chame-a

Antes de usar

• !É necessária uma chave de API de um provedor de LLM (como OpenAI ou Anthropic) ou uma configuração de modelo compatível.

Em coleções

Tópicos

Perguntas frequentes

O que é promptic?

Uma biblioteca leve de decorators para Python que transforma docstrings em prompts para LLMs, com saídas Pydantic, chamadas de ferramentas, streaming e memória, usando LiteLLM. Promptic é uma pequena biblioteca Python para criar aplicações com LLMs. Você decora uma função com @llm, e a docstring dela se torna o template do prompt, preenchido com os argumentos da função. A chamada retorna diretamente a resposta do modelo, então uma função pode servir como prompt sem precisar lidar manualmente com as requisições.

promptic é gratuito? Qual é a licença?

promptic é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

promptic ainda é mantido?

Manutenção ativa. O último commit de promptic foi em 12 de out. de 2026.

Para que posso usar promptic?

Criar protótipos de funcionalidades com LLMs em Python sem escrever código repetitivo para as requisições. Extrair dados tipados de textos ou imagens e convertê-los em objetos Pydantic. Criar um chatbot ou agente simples que chama funções Python como ferramentas. Alternar entre provedores de LLM sem reescrever o código da aplicação.

Como instalar promptic?

Instale promptic pelo PyPI: pip install promptic Defina a chave de API do seu provedor de LLM como uma variável de ambiente (exemplo para OpenAI): export OPENAI_API_KEY=sk-... Decore uma função com @llm, usando a docstring como prompt, e chame-a

Onde consigo promptic?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/knowsuchagency/promptic