Repolode
Mattie

Mattie/cataclysm

Uma biblioteca Python que usa um LLM da OpenAI para gerar implementações de funções em tempo de execução com base nos nomes, argumentos e contexto.

Estrelas
409
Forks
43
Issues abertas
11
Último commit
há 13 dias

O que é?

Cataclysm permite que código Python chame funções que ainda não têm implementação. Quando uma função desconhecida é chamada, a biblioteca envia o nome da função, os argumentos, os nomes dos argumentos nomeados, as docstrings, os comentários e o contexto da pilha de chamadas a um modelo da OpenAI, executa o código gerado e retorna o resultado. O código gerado é armazenado em arquivos locais por assinatura de função, para que chamadas posteriores possam reutilizá-lo.

A biblioteca oferece vários modos. `consume(globals())` habilita a geração para qualquer função desconhecida no namespace atual, o que é útil em notebooks e experimentos. O módulo `doom` é o ponto de entrada recomendado para bibliotecas e apps. `doom.impending` exibe uma prévia do código gerado sem executá-lo, e `doom.chosen` executa apenas código armazenado em cache e lança NameError quando não há nada em cache, garantindo que o código publicado nunca chame o modelo.

A configuração requer Python 3.11 ou mais recente, uma chave da OpenAI API em um arquivo `.env` e o comando `cataclysm init` para copiar os arquivos padrão de prompt e dados. A geração é feita por meio da biblioteca chatsnack, e o arquivo de prompt pode ser editado para alterar o comportamento ou trocar por um modelo mais barato.

Recursos principais

  • 01Gera implementações para funções ausentes com base nos nomes, argumentos e contexto.
  • 02Armazena o código gerado localmente por assinatura de função para reutilização.
  • 03Oferece o módulo `doom`, recomendado para uso em bibliotecas e apps.
  • 04Oferece um modo de prévia (`doom.impending`) para inspecionar o código antes da execução.
  • 05Oferece um modo congelado (`doom.chosen`) que executa apenas código armazenado em cache.

Casos de uso

  • Prototipar funções rapidamente em notebooks Jupyter ou sessões interativas.
  • Explorar como um LLM implementaria uma função utilitária a partir da assinatura.
  • Publicar um aplicativo com código pré-gerado que nunca chama o modelo em tempo de execução.

Início rápido

  1. 1

    Instale o pacote pelo PyPI

    pip install cataclysm
  2. 2

    No diretório do seu projeto, copie os arquivos de dados padrão

    cataclysm init
  3. 3

    Adicione sua chave de API da OpenAI ao arquivo .env

Antes de usar

  • Requer uma chave de API da OpenAI e faz chamadas à API paga da OpenAI.
  • Requer Python 3.11 ou superior.
  • O código gerado não é verificado e o README alerta que ele pode ser inseguro; é experimental.

Tópicos

Perguntas frequentes

O que é cataclysm?
Uma biblioteca Python que usa um LLM da OpenAI para gerar implementações de funções em tempo de execução com base nos nomes, argumentos e contexto. Cataclysm permite que código Python chame funções que ainda não têm implementação. Quando uma função desconhecida é chamada, a biblioteca envia o nome da função, os argumentos, os nomes dos argumentos nomeados, as docstrings, os comentários e o contexto da pilha de chamadas a um modelo da OpenAI, executa o código gerado e retorna o resultado. O código gerado é armazenado em arquivos locais por assinatura de função, para que chamadas posteriores possam reutilizá-lo.
cataclysm é gratuito? Qual é a licença?
cataclysm é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
cataclysm ainda é mantido?
Manutenção ativa. O último commit de cataclysm foi em 24 de out. de 2026.
Para que posso usar cataclysm?
Prototipar funções rapidamente em notebooks Jupyter ou sessões interativas. Explorar como um LLM implementaria uma função utilitária a partir da assinatura. Publicar um aplicativo com código pré-gerado que nunca chama o modelo em tempo de execução.
Como instalar cataclysm?
Instale o pacote pelo PyPI: pip install cataclysm No diretório do seu projeto, copie os arquivos de dados padrão: cataclysm init Adicione sua chave de API da OpenAI ao arquivo .env
Onde consigo cataclysm?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Mattie/cataclysm

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

Projetos relacionados