Skip to main content

Cattykit

Cattykit (in development) is a framework for implementing artificial intelligence models based on components from the cognitive models of the Fluid Analogies Research Group described in Hofstadter et al 1995. Their models are typically built with similar components, including: a shared workspace, slipnet, coderack, and codelets.

Models solve problems represented by graph-like structures in a workspace which is incrementally edited by micro-agents called codelets that propose, build, and destroy new structures. The slipnet keeps track of concepts relevant to the structures present in the workspace and encourages codelets that continue their construction. The coderack is a stochastic scheduler of codelets, which are selected according to urgency. All processes in each model occur with a degree of randomness mediated by its temperature which (unlike the related concept used in language model decoding and simulated annealing) is a measure of workspace quality constantly adjusted by the model itself.

This repository was initially motivated by the lack of a common software framework for FARG models, which were typically developed as isolated projects, often using different programming languages (some of which are now obsolete). This hinders further research into the models and, despite the promise they show as an approach to symbolic AI, acts as a barrier to their adoption in AI more widely.

Installation

Install with pip:

pip install cattykit

Quick start

Start by installing a model in your environment (this requires pip in the local environment).

import cattykit

# providing a name will install the model from the Cattykit repository
cattykit.install_model("copycat")

print(cattykit.available_models())
# ('cattykit',)

# providing a uri will install a model from your computer or elsewhere
cattykit.install_model("path/to/model")

The same installation is available from the command line:

cattykit install copycat --version 0.1.0

Once you have installed a model, you can ask it to solve a problem.

import cattykit

copycat = cattykit.load_model("copycat", config={"seed": 1234})

result = copycat.solve("abc -> abd ==> ijk -> ?")

print(result)
# 'ijl'

References

  • Hofstadter, D. R., et al. (1995). Fluid Concepts and Creative Analogies: Computer Models of the Fundamental Mechanisms of Thought. Basic Books. doi:10.5555/218753
  • Mitchell, M (1993). Analogy-Making as Perception: A Computer Model. The MIT Press. doi:10.5555/152203

License

Cattykit is licensed under the GNU Affero General Public License v3.0 or later. See LICENSE for details.

Metadata

Release files for cattykit 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cattykit 0.1.3
File Size Uploaded Provenance Actions
cattykit-0.1.3.tar.gz 58.0 kB With provenance Details for cattykit-0.1.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for cattykit 0.1.3
File Interpreter ABI Platform Actions
cattykit-0.1.3-py3-none-any.whl Python 3 none any Details for cattykit-0.1.3-py3-none-any.whl

Total release size: 108.1 kB

Release files / cattykit-0.1.3.tar.gz

Download URL cattykit-0.1.3.tar.gz
Size 58.0 kB
Tags Source
SHA-256 checksum
How to use checksums
0a7a286685894f0ce9de6ead5d31e841486b1fc45d0e8188f56e767e645f4ef5
BLAKE2b-256 checksum
How to use checksums
1d351b163aab35a17e5fb8999ef20ef2cbedc84363d863511bc7bab5860766dd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.

Transparency log

Release files / cattykit-0.1.3-py3-none-any.whl

Download URL cattykit-0.1.3-py3-none-any.whl
Size 50.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
69c80ee276c8b25cbdeb64d18d70b961766f170fe2d62757901e9ba0fed0d6b0
BLAKE2b-256 checksum
How to use checksums
b135c5213d5f61ad3e5a31db9616085fbaeb625a8c04c5ce74d95c6e66bd9cc3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.

Transparency log

Security for cattykit 0.1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for cattykit-0.1.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 12, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page