Skip to main content

PredaCore — your personal autonomous agent with an infinite context window and memory.

This project has been archived.

The maintainers of this project have marked this project as archived. No new releases are expected.

Project description

PredaCore

PredaCore

Your personal super-agent.

Infinite memory. Infinite context for your work. Self-evolving.
Runs on your laptop. Uses your AI models. Owns nothing about you.

Local First Rust Memory Kernel 24/7 Daemon Apache 2.0


Most AI forgets you.

PredaCore remembers.

It remembers your projects, bugs, preferences, files, decisions, workflows, and the way you like things done.

Then it acts.

It can read your code, browse the web, control apps, run commands, send messages, schedule work, use channels, spawn agents, and keep learning from every conversation.

You:        remember that auth bug from last month?

PredaCore:  yes — api_client.py dropped headers on retry.
            You fixed it there.

            The same pattern still exists in webhook_retry.py.
            Want me to patch it too?

That is the pitch.

An AI that does not reset every time you close the tab.


What PredaCore really is

PredaCore is a local agent runtime for your work.

It gives any AI model:

  • long-term memory
  • a body that can use tools
  • armor that protects files, keys, and approvals
  • a 24/7 daemon that keeps work alive
  • channels to reach you where you already are
  • skills that evolve from repeated workflows
  • agents that can split up bigger jobs
  • a fast Rust memory kernel under the hood

The model is the brain.

PredaCore is the body, armor, memory, tools, daemon, and nervous system.

Your AI stops being a floating chat box.

It becomes something that can remember, act, recover, and grow.


Install

pipx install "predacore[full]"
predacore setup
predacore chat

No pipx?

brew install pipx
# or
python -m pip install --user pipx

Install options:

pipx install predacore            # base
pipx install "predacore[full]"    # desktop, Android, voice, local extras
pipx install "predacore[server]"  # API server, monitoring, agent fabric

What you can ask it

find the bug from last week
read this repo and explain the auth flow
remember that I prefer pytest
index ~/Developer/myapp into memory
search the web and summarize the latest docs
open Chrome and check this dashboard
take a screenshot and tell me what is broken
run this script and fix the error
send this summary to Telegram
reply to the last Discord message
check this deploy every 5 minutes
spawn agents to research these ideas
connect this MCP server
add this REST API as a tool

Or just ask:

what can you do?

Feature map

Memory · Code · Files · Web · Chrome · Desktop · Android · Voice
Images · Diagrams · Channels · Schedules · MCP · APIs · Skills
Multi-agent work · Safety · Local daemon · Rust memory kernel

Superpowers

Infinite memory

PredaCore keeps memory across sessions.

Not just chat history.

It remembers:

  • what you built
  • what broke
  • what you fixed
  • what you decided
  • what you prefer
  • what files matter
  • what should be ignored

Underneath, a fast Rust memory kernel does the heavy lifting in the background.

You do not manage a memory tab.

You just use it.


Infinite context for your work

Normal AI has a context window.

PredaCore builds context over time.

It can remember old conversations, search your files, index your codebase, track decisions, and pull the right thing back when you need it.

So instead of pasting the same explanation again and again, you can say:

continue from where we left off

And it actually knows what that means.


Self-healing memory

Memory breaks in normal agents.

Files move. Branches change. Code gets renamed. Notes go stale. Laptops crash.

PredaCore keeps checking its own memory.

It can detect stale memories, repair broken links, protect against accidental deletion, keep snapshots, and recover when something goes wrong.

So when it remembers a bug from three weeks ago, it is not just repeating old chat.

It is trying to keep that memory attached to the real project.


Code memory you can trust

PredaCore does not only remember that something happened.

It tries to remember where it happened.

When a file changes, PredaCore can re-check whether an old memory still points to the right code.

So a memory like this stays useful:

the retry bug was in api_client.py

Even after the project moves forward.


Self-evolving

PredaCore changes as you use it.

It can learn your style, remember your workflows, notice repeated patterns, and turn them into reusable skills.

Use it for a week and it knows your preferences.

Use it for a month and it understands your projects.

Use it for a year and it becomes a different agent from the one you installed.

More useful.

More yours.


Skills that evolve

PredaCore can notice repeated workflows.

If you keep asking it to release a package, debug a deploy, summarize a repo, or prepare a report, it can turn that pattern into a reusable skill.

You do not just teach it facts.

You teach it ways of working.


Runs while you sleep

PredaCore can run as a local daemon.

Start it once:

predacore start --daemon

Then it can keep watching, remembering, checking, scheduling, and working while you do other things.

Ask it to:

check the deploy every 5 minutes
summarize unread emails every morning
watch this page for changes
keep retrying until it succeeds

Stop it anytime:

predacore stop

Your agent does not have to live inside one terminal window.

It can stay alive with your machine.


Built-in powers

Files and code

PredaCore can read files, edit files, search repos, explain code, run scripts, fix errors, and remember project decisions.

read api_client.py and explain the retry logic
search the repo for anything that touches auth
run tests and fix the failing one
what changed since yesterday?

Web and browser

PredaCore can search the web, open pages, read PDFs, scrape data, and control Chrome.

search the latest docs for this API
open this dashboard and tell me what is failing
read this PDF and pull out the key dates

Desktop, phone, voice, and images

PredaCore can work with the machine in front of you.

It can use screenshots, desktop control, Android control, voice notes, speech, image generation, and diagrams.

take a screenshot and tell me what is broken
click the Send button
listen to this voice note
speak the summary out loud
draw a system diagram
generate a hero image

Channels

PredaCore can talk through the tools you already use.

Telegram
Discord
Slack
WhatsApp
iMessage
Email
Signal
Matrix
IRC
Bluesky
Mastodon
Google Chat
Webchat
and more

Ask:

send this report to my Telegram
reply to the last Discord message in #engineering
email this summary to the team

MCP and APIs

PredaCore can plug into external tools.

add an MCP server for my Notion workspace
connect this REST API and call it like a tool
add my Anthropic key

You can give it more hands whenever your workflow needs them.


Multi-agent work

For big tasks, PredaCore can split the work.

spawn 5 agents to research these 5 ideas
compare their answers and give me the best plan
keep working on this until done

One agent can research.

Another can verify.

Another can write.

Another can critique.

PredaCore can coordinate the work.


Background work

PredaCore can keep tasks alive across restarts.

every weekday at 9am, summarize unread emails
check the deploy every 5 minutes
keep retrying this job with backoff
watch this page and tell me when it changes

The chat can end.

The work can continue.


Local-first

PredaCore stores its world here:

~/.predacore/

Important paths:

~/.predacore/config.yaml       # config
~/.predacore/.env              # API keys
~/.predacore/memory/           # memory
~/.predacore/cron_tasks.json   # scheduled work

Delete the folder and the local memory is gone.

No vendor owns your agent.

No account ban erases your history.

No cloud workspace controls your assistant.

Your machine.
Your models.
Your data.


Bring your own AI

PredaCore works with the AI models you choose:

  • Claude
  • GPT
  • Gemini
  • OpenRouter
  • Ollama
  • LM Studio
  • Kimi
  • Qwen
  • Perplexity
  • your own endpoint

The model is the brain.

PredaCore is the body, armor, memory, tools, daemon, channels, scheduler, and agent runtime.


Safety by default

PredaCore can touch real files, browsers, terminals, apps, and messages.

So it has guardrails.

It can protect approvals, block dangerous commands, avoid sensitive files, filter secrets, limit risky paths, scan identity files, and keep an audit trail.

Default mode is careful.

Power users can use beast mode when they know exactly what they are doing.


Commands

predacore setup              # guided setup
predacore chat               # talk in terminal
predacore start --daemon     # run in background
predacore stop               # stop daemon
predacore status             # check health
predacore doctor             # full diagnostic
predacore logs -f            # follow logs

Benchmark

0.9574 R@5 on LongMemEval

LongMemEval is a 500-conversation memory-recall benchmark from ICLR 2025.

Benchmark artifacts live in:

benchmarks/

Reported reproduction notes:

  • deterministic retrieval
  • no LLM randomness during recall
  • roughly 55 minutes to reproduce on a Mac
  • zero per-query API cost

Honest limits

PredaCore is powerful, but not magic.

  • Windows desktop control is not fully built yet.
  • Some features need local permissions.
  • Channel integrations need your own accounts or tokens.
  • Heavy parallel use needs care.
  • beast mode can spend aggressively if you let it.
  • The Python repo is Apache 2.0; the Rust memory kernel is distributed separately as prebuilt wheels.

Help

Docs are being rewritten.

For now:

predacore chat

Then ask:

what can you do?

Apache 2.0 · Built by @rockshub1

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

predacore-1.6.11.tar.gz (1.0 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

predacore-1.6.11-py3-none-any.whl (1.1 MB view details)

Uploaded Python 3

File details

Details for the file predacore-1.6.11.tar.gz.

File metadata

  • Download URL: predacore-1.6.11.tar.gz
  • Upload date:
  • Size: 1.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for predacore-1.6.11.tar.gz
Algorithm Hash digest
SHA256 706d4534db00c8c522e67760b78eb4ac99589d771073c6fabf8885aac698c25a
MD5 9575ba92c3262a04f31625ebdd8fb65b
BLAKE2b-256 954899a1637ca75cf094419b69b8eb8579e0ad502d74046dad7eacb284856c98

See more details on using hashes here.

Provenance

The following attestation bundles were made for predacore-1.6.11.tar.gz:

Publisher: publish-python.yml on rockshub1/predacore

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file predacore-1.6.11-py3-none-any.whl.

File metadata

  • Download URL: predacore-1.6.11-py3-none-any.whl
  • Upload date:
  • Size: 1.1 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for predacore-1.6.11-py3-none-any.whl
Algorithm Hash digest
SHA256 0e244e337b57523443db590a22ed6f4e898b6d90cede06675e9b8b9f3eaed371
MD5 4908c2d3d8e5a67b06ec3c9e658b9f54
BLAKE2b-256 b619cde4680c5ce52287636122957e505f5446a5df308500fae849767d4dcb5a

See more details on using hashes here.

Provenance

The following attestation bundles were made for predacore-1.6.11-py3-none-any.whl:

Publisher: publish-python.yml on rockshub1/predacore

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page