Maxim生物启发认知架构

Entropic drive — drifts away, requires external action

hunger: drive: drift_mode: entropic drift_direction: up drift_rate: 0.006 deprivation_threshold: 0.7 deprivation_pain: 0.3 ```

Three sensation layers converge on the same pipeline: - Contact (entity acquisition): pick up a rock → its sensors join your body → damage model evaluates - Touch (self_effect): touch fire → one-time thermal spike on arms - Narrative (keyword reflexes): narrator describes flames → reflex fires → damage → pain

All produce: sensor change → evaluate_failures() → PainBus → NAc learning.

Start the agentic loop (requires a configured LLM backend)

maxim.run(model="mistral-7b")

requires: pip install 'pymaxim[llm-llama,llm-server]'

pip install 'pymaxim[llm-llama,llm-server]' maxim --list-models # see available models maxim --sim "test memory recall" --llm mistral-7b # auto-downloads on first run

requires: pip install 'pymaxim[llm-llama,llm-server,semantic]'

maxim --sim cradle --embodiment bodies/infant_humanoid --sim-max-turns 25 ```

Check your setup with maxim doctor, and find simulation reports in ~/.maxim/sim_reports/{session_id}/.

Installation

pip install pymaxim

requires: pip install 'pymaxim[llm-llama,llm-server,semantic]'

import maxim

Quickstart

```bash

Website Guides

The dennyschaedig.com/maxim site hosts long-form topic guides covering the full architecture. These are the deep-dive companion to this README:

Optional Extras

See getting-started.md for the full list of 16 extras.

Note: [all] does not include [semantic] (sentence-transformers + spaCy). Without it, memory recall and substrate encoding fall back to bag-of-words hashing. For full memory quality:

> pip install 'pymaxim[all,semantic]'
> 

```bash

Diagnose environment

report = maxim.diagnose()

Configuration

maxim config list # show all resolved settings maxim config get lanes.large.remote_url # get a single field maxim config set cloud.enabled true # set a field

Or with a local model (no API key needed)

Python API

```python

CLI Quick Reference

```bash