Skip to main content

ZAI Core โ€” A lightweight modular AI framework with 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.1.tar.gz (5.1 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.1-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: zaicore-0.2.1.tar.gz
  • Upload date:
  • Size: 5.1 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.1.tar.gz
Algorithm Hash digest
SHA256 70c7fd6d3e23359c8548f4e140c6ac46fea1935910400df04f390e3a911fb211
MD5 3086d0d05969c16ca7a679f2f53a5491
BLAKE2b-256 850edbe5d7ec3331398c6cfd187f27fa6b1bd636587a1db624ea181428c5e224

See more details on using hashes here.

File details

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

File metadata

  • Download URL: zaicore-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 5.5 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 804856bff2124f1b2b0afccb3c668fd73f4d056dceaf9705538bef067e7fdf33
MD5 0fb0b3b8099447b26858a9979362f87a
BLAKE2b-256 ef739bdcf9d0fb6ffda2d23e3b2cc3147223c4d92e4add79dcc47292f713a34c

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