Skip to content

A Flask-based AI chatbot with memory and PDF learning support. Sayaka-Nao is your intelligent daily and learning companion.

License

Notifications You must be signed in to change notification settings

PurnamaRidzkyN/Sayaka-Nao

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sayaka-Nao

Sayaka-Nao is a Flask-based web AI chatbot that acts as Tsuki’s partner. She has memory to remember both casual daily conversations and serious discussions to help with learning. To assist the learning process, she can also accept PDF uploads to expand her knowledge and provide more insightful responses.


Project Status

⚠️ Sayaka-Nao is currently under active development. This project is currently under active development.
Some features are not yet implemented or may be incomplete.
Feel free to contribute or open issues for suggestions and improvements.


Main Features

  • Daily Plan: A relaxed daily chat feature to hang out and talk about your day.
  • Learn Plan: Supports your learning process through interaction and exercises with Sayaka-Nao.
  • Interactive Chat: Chat freely with Sayaka-Nao.
  • PDF Upload: Enrich the AI’s knowledge by importing materials from PDF files, making its “brain” smarter and more informative.

Technology

  • Flask as the backend web framework.
  • Gemma as the core AI framework.
  • Written in Python.
  • Dependencies listed in requirements.txt.

Installation

  1. Clone the repository:

    git clone https://github.com/PurnamaRidzkyN/Sayaka-Nao.git
    cd Sayaka-Nao
  2. Create a virtual environment:

    python -m venv venv
    source venv/bin/activate  # Linux/Mac
    venv\Scripts\activate     # Windows
  3. Install dependencies:

    pip install --upgrade -r requirements.txt
    
  4. Run the application:

    python run.py
  5. Open your browser and go to http://localhost:5000.


Important Notes

  • The folder app/memory and the file app/persona.py are not included in the repository due to .gitignore, but they are essential for the AI functionality.
  • app/memory stores the AI’s memory data, keeping conversation context that helps the AI “remember” and learn.
  • app/persona.py contains the AI’s persona profile that defines how it interacts and responds to users.
  • Make sure to create or backup these files and folders to ensure optimal AI performance.

How to Use

  • Chat with Sayaka-Nao directly on the main page.
  • Create daily and learning plans using the available features.
  • Upload PDF files to expand the AI’s knowledge.
  • The AI will process the PDF content and adapt its responses based on the new knowledge.

Contributing

Feel free to fork, modify, and submit pull requests. Please keep your code clean and well-documented.


License

This project is protected under the Purnama License (Non-Commercial Use):

  • ✅ Free to use for personal, educational, and non-commercial purposes.
  • 🚫 Commercial use (selling, monetizing, paid services, etc.) is prohibited without the creator’s permission.

For commercial inquiries or permission, contact:


Contact

Purnama Ridzky N GitHub: https://github.com/PurnamaRidzkyN

About

A Flask-based AI chatbot with memory and PDF learning support. Sayaka-Nao is your intelligent daily and learning companion.

Topics

Resources

License

Stars

Watchers

Forks