Skip to main content

ZAI Core โ€” Cognitive AI Framework with Contextual Reasoning and Persistent Memory

Project description

๐Ÿง  ZAI Core

v0.2.0 โ€” Persistent Brain Update

PyPI Python License Made in Indonesia


๐Ÿงฉ Overview

ZAI Core is a modular Python-based AI framework built by Muhammad Zaidan.
Version v0.2.0 introduces Persistent Memory, allowing ZAI Core to remember what it learns โ€” permanently.

โ€œNow your AI remembers โ€” even after shutdown.โ€


โš™๏ธ Features (v0.2.0)

  • ๐Ÿง  Persistent Brain โ€” Memory is saved in zai_memory.json
  • ๐Ÿ’พ Auto Save System โ€” Every learn() updates memory instantly
  • ๐Ÿ” Recall Intelligence โ€” Retrieve old knowledge anytime
  • ๐Ÿงฉ Forget & Wipe โ€” Erase single or all stored memories
  • ๐Ÿง  CLI Mode โ€” Use ZAI Core directly from terminal
  • ๐Ÿ”ง Configurable Path โ€” Custom memory file location

๐Ÿงฑ Folder Structure

./ZAI-Core/
โ”‚
โ”œโ”€โ”€ ./zaicore/
โ”‚   โ”œโ”€โ”€ ./__init__.py
โ”‚   โ”œโ”€โ”€ ./__main__.py          # CLI Interface
โ”‚   โ”œโ”€โ”€ ./core.py              # Main AI Core Logic (Persistent Memory)
โ”‚   โ””โ”€โ”€ ./utils/
โ”‚       โ”œโ”€โ”€ ./__init__.py
โ”‚       โ””โ”€โ”€ ./data_handler.py  # Memory I/O Handler
โ”‚
โ”œโ”€โ”€ ./docs/
โ”‚   โ””โ”€โ”€ ./architecture.md
โ”‚
โ”œโ”€โ”€ ./setup.py
โ”œโ”€โ”€ ./setup.cfg
โ”œโ”€โ”€ ./LICENSE
โ””โ”€โ”€ ./README.md

๐Ÿ’ป Quick Start

Installation

pip install zaicore

Example (Python)

from zaicore import ZAICore

ai = ZAICore()

ai.learn("mission", "to build adaptive AI frameworks")
ai.learn("creator", "Muhammad Zaidan")

ai.recall("mission")
ai.recall("creator")

Output:

๐Ÿง  ZAI Core v0.2.0 initialized โ€” Persistent Brain Online.
[Learning] Stored: mission -> to build adaptive AI frameworks
[Learning] Stored: creator -> Muhammad Zaidan
[Recall] mission: to build adaptive AI frameworks
[Recall] creator: Muhammad Zaidan

๐Ÿง  CLI Mode

You can now talk to ZAI Core directly from your terminal.

python -m zaicore

Example Interaction:

๐Ÿš€ Launching ZAI Core v0.2.0 โ€” CLI Mode
๐Ÿง  ZAI Core v0.2.0 initialized โ€” Persistent Brain Online.
Type 'exit' to quit.

๐Ÿง  > learn name = Zaidan
[Learning] Stored: name -> Zaidan

๐Ÿง  > recall name
[Recall] name: Zaidan

๐Ÿง  > forget name
[Forget] Key 'name' removed from memory.

๐Ÿง  > wipe
๐Ÿงน All memory wiped clean.

๐Ÿง  > exit
๐Ÿ‘‹ Shutting down ZAI Core...

โš™๏ธ Developer Notes

ZAI Core stores all learned data in a file called:

./zai_memory.json

To reset everything manually:

rm zai_memory.json

๐Ÿงฉ Development Roadmap

Version Feature Status
v0.1.0 Basic AI learn & recall system โœ… Released
v0.2.0 Persistent Brain + CLI Mode ๐Ÿง  Active
v0.3.0 Chat Interface + Plugin Loader ๐Ÿ”œ Planned

๐Ÿง‘โ€๐Ÿ’ป Author

Muhammad Zaidan Faiz
๐Ÿ’ผ LinkedIn
๐ŸŒ GitHub
๐Ÿ“ง muhammadzaidanfaiz8@gmail.com


๐Ÿ“„ License

Released under the MIT License โ€” free to learn, modify, and expand.


โญ ZAI Core โ€” The brain that never forgets.

๐Ÿ’ฌ โ€œDonโ€™t just build AI. Build something that learns with you.โ€

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

zaicore-0.2.2.tar.gz (5.7 kB view details)

Uploaded Source

Built Distribution

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

zaicore-0.2.2-py3-none-any.whl (6.3 kB view details)

Uploaded Python 3

File details

Details for the file zaicore-0.2.2.tar.gz.

File metadata

  • Download URL: zaicore-0.2.2.tar.gz
  • Upload date:
  • Size: 5.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for zaicore-0.2.2.tar.gz
Algorithm Hash digest
SHA256 c8cd3da35f001642c045992db091e9d24dfe41eb184a12a27998db9e4788eff8
MD5 c623a84e17c25cb16ad233f799a8fa37
BLAKE2b-256 74dc4f6d63d7ca421734c8ebd091da7414c07c96f36711217bc18c89d7215076

See more details on using hashes here.

File details

Details for the file zaicore-0.2.2-py3-none-any.whl.

File metadata

  • Download URL: zaicore-0.2.2-py3-none-any.whl
  • Upload date:
  • Size: 6.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for zaicore-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b95c5e559273a180da9a17bb9d57a843264d823f41a38a0c0cefc4236967c81b
MD5 9cd7006d6ec6e4d8817c66bce2911388
BLAKE2b-256 3ebae1cf0e1a144dae10271aeb249d7cb37e2c29aedda346d79aa5a838bea7db

See more details on using hashes here.

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