# lupantech/chameleon-llm

Codes for "Chameleon: Plug-and-Play Compositional Reasoning with Large Language Models".

Repository: https://github.com/lupantech/chameleon-llm
Canonical: https://ross.abutalabs.com/products/chameleon-llm
Homepage: https://chameleon-llm.github.io
Language: Jupyter Notebook
License: Apache-2.0
License Family: permissive
Topics: python, ai, chatgpt, gpt-4, llm, openai, tool
Last push: 2023-12-23T03:36:42+00:00

## Health v2 (maintenance only)
Score: 20/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 88
- inputs: {"age_days": 1232, "days_push": 984, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1139, forks 82 (observed 2026-08-28T04:03:44.213870+00:00)

## What it is
Chameleon is a research framework for plug-and-play compositional reasoning with large language models, where an LLM planner synthesizes programs that compose tools such as vision models, web search, Python execution, and rule-based modules. It accompanies the NeurIPS 2023 paper and provides code and benchmarks (ScienceQA, TabMWP) demonstrating enhanced reasoning with GPT-4/ChatGPT.

## Use cases
- build an llm agent that chains tools like search and python execution
- reproduce the chameleon compositional reasoning paper results
- evaluate gpt-4 on scienceqa and tabmwp benchmarks
- prototype a planner that composes modular tools for question answering
- augment llm reasoning with vision models and knowledge retrieval

## When to choose
- you want a research-grade example of LLM tool-use planning and composition
- you need to reproduce or extend the Chameleon paper's benchmarks
- you're exploring plug-and-play tool augmentation for GPT-4/ChatGPT

## When to avoid
- you need a production-ready, maintained agent framework
- you want to use open-source local LLMs rather than OpenAI APIs
- you need long-term support, as the repo is research code from 2023

## Facets
- artifact type: framework
- maturity: maintenance
- function: agent-framework, llm-inference, prompt-engineering, rag, nlp
- domain: artificial-intelligence, large-language-models
- platform: python
- tags: compositional-reasoning, tool-use, gpt-4, research-code, planner, ai-agents, natural-language-processing

## Member repositories
- lupantech/chameleon-llm (main) score 20

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:44.213870+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:35:52.823969+00:00, confidence not recorded.
  - readme: https://github.com/lupantech/chameleon-llm (fetched 2026-08-28T04:03:44.213870+00:00, sha 9e31ec27c75c)
  - homepage: https://chameleon-llm.github.io (fetched 2026-08-29T12:41:00.819938+00:00, sha 7c9d5b44f8cf)
- Data as of 2026-08-30T08:39:29.467469+00:00.