Skip to main content

ALLELE

Phylogenic AI Agents

Python Version License PyPI

Beyond Prompt Engineering. Evolve Genetically Optimized Personalities with Liquid Memory.


Don't Write Prompts. Breed Agents.

Traditional Agents are brittle. They hallucinate, drift, and forget.

Allele changes the substrate.

We replaced static prompts with 8-Trait Genetic Code and Liquid Neural Networks (LNNs).


The Problem

Prompting is guessing. You change one word, the whole personality breaks.

  • ❌ Brittle system prompts
  • ❌ No memory coherence
  • ❌ Manual trial-and-error optimization
  • ❌ Agents that drift over time

The Solution

Allele treats Agent personalities like DNA, not text.

Instead of writing prompts, you define a Genome with 8 evolved traits:

from allele import ConversationalGenome, create_agent, AgentConfig

# Define personality as genetic code
genome = ConversationalGenome(
    genome_id="support_agent_v1",
    traits={
        'empathy': 0.95,              # High emotional intelligence
        'technical_knowledge': 0.70,  # Moderate technical depth
        'creativity': 0.30,           # Focused responses
        'conciseness': 0.85,          # Brief and clear
        'context_awareness': 0.90,    # Strong memory
        'engagement': 0.85,           # Warm personality
        'adaptability': 0.75,         # Flexible style
        'personability': 0.90         # Friendly demeanor
    }
)

# Create agent from genome
config = AgentConfig(model_name="gpt-4", kraken_enabled=True)
agent = await create_agent(genome, config)

# Chat with genetically-defined personality
async for response in agent.chat("I need help"):
    print(response)

Core Innovation

🧬 Genetic Personality Encoding

8 quantified personality traits (0.0 to 1.0) define each agent:

  • Empathy - Emotional understanding
  • Technical Knowledge - Technical depth
  • Creativity - Problem-solving novelty
  • Conciseness - Brevity vs detail
  • Context Awareness - Memory retention
  • Engagement - Conversational energy
  • Adaptability - Style flexibility
  • Personability - Friendliness

🧪 Evolutionary Optimization

# Don't manually tune. Evolve.
engine = EvolutionEngine(config)
population = engine.initialize_population(size=50)

best = await engine.evolve(population, fitness_fn)
# 20 generations → optimized personality

🧠 Kraken Liquid Neural Networks

Temporal memory via Liquid Neural Networks (not static vectors):

kraken = KrakenLNN(reservoir_size=100)
context = await kraken.process_sequence(conversation)
# <10ms latency, adaptive dynamics

Installation

pip install allele

# With LLM providers
pip install allele[openai]    # OpenAI
pip install allele[anthropic] # Anthropic Claude
pip install allele[ollama]    # Ollama (local)
pip install allele[all]       # All providers

Why Allele?

Feature Traditional Allele
Personality Prompt strings Genetic code
Optimization Manual tweaking Auto-evolution
Memory Vector stores Liquid neural nets
Reproducibility Copy-paste prompts Version genomes
Explainability Black box Trait values

Benchmarks

  • Crossover: <5ms (breeding is cheap)
  • LNN Processing: <10ms (temporal coherence)
  • Memory: ~2KB per genome
  • Code Quality: 8.83/10, 100% tests passing

Use Cases

  • 🏥 Healthcare: High empathy + medical knowledge
  • 💼 Sales: High engagement + persuasion
  • 👨‍💻 Dev Tools: High technical + conciseness
  • 🎓 Education: High adaptability + patience
  • 🔒 Security: High precision + context awareness

Documentation


Testing

pytest                                    # Run all tests
pytest --cov=allele --cov-report=html    # With coverage

Contributing

We welcome contributions! See CONTRIBUTING.md.


License

MIT License - see LICENSE


Links


Made with genetic algorithms and liquid neural networks

Don't write prompts. Breed agents. 🧬

Release files for allele 1.0.1

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

Source distribution (sdist)

Source distribution for allele 1.0.1
File Size Uploaded
allele-1.0.1.tar.gz 21.1 kB Details

Built distribution (wheel)

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

Total release size: 41.0 kB

Release files / allele-1.0.1.tar.gz

Download URL allele-1.0.1.tar.gz
Size 21.1 kB
Tags Source
SHA-256 checksum
How to use checksums
3f216756ee62857a78d704ce4934f0d63efcfbd550902caf4a5c36816b4cdc8e
BLAKE2b-256 checksum
How to use checksums
4e9a890a6caf14e85fda84cadd27122d3a1e4d32a8c63423b771cc8a27a4896c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release files / allele-1.0.1-py3-none-any.whl

Download URL allele-1.0.1-py3-none-any.whl
Size 19.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
68b32e9f52c216d33b8d7d60d79ea5e6a6f1665e477fd652c6cc82a4f521af0f
BLAKE2b-256 checksum
How to use checksums
185c1a9dd701f9d273be4491c743ef2747748b6419789483cf23380a8e12396a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files

1.0.0

2 release files

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