{"id":26992095,"url":"https://github.com/pointlessai/chatbot-memory","last_synced_at":"2025-04-03T22:18:45.529Z","repository":{"id":274252278,"uuid":"922362159","full_name":"PointlessAI/chatbot-memory","owner":"PointlessAI","description":"Long Term Memory Chatbot A sophisticated AI chatbot with persistent personality and memory, designed to maintain consistent character traits and conversation history across sessions.","archived":false,"fork":false,"pushed_at":"2025-04-03T14:22:36.000Z","size":64,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-03T15:29:29.515Z","etag":null,"topics":["ai","chatbot","chatgpt-bot","gpt"],"latest_commit_sha":null,"homepage":"https://pointlessai.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PointlessAI.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-26T01:43:14.000Z","updated_at":"2025-04-03T14:22:39.000Z","dependencies_parsed_at":"2025-01-27T13:29:47.946Z","dependency_job_id":"de879cb1-0e01-4712-a3a4-9bc23f3a51a2","html_url":"https://github.com/PointlessAI/chatbot-memory","commit_stats":null,"previous_names":["pointlessai/gpt-personality","pointlessai/chagtgpt-api-personality","pointlessai/phishermans-friend","pointlessai/chatbot-memory"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PointlessAI%2Fchatbot-memory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PointlessAI%2Fchatbot-memory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PointlessAI%2Fchatbot-memory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PointlessAI%2Fchatbot-memory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PointlessAI","download_url":"https://codeload.github.com/PointlessAI/chatbot-memory/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247085995,"owners_count":20881160,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","chatbot","chatgpt-bot","gpt"],"created_at":"2025-04-03T22:18:44.947Z","updated_at":"2025-04-03T22:18:45.522Z","avatar_url":"https://github.com/PointlessAI.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Long Term Memory Chatbot\n\nA sophisticated AI chatbot with persistent personality and memory, designed to maintain consistent character traits and conversation history across sessions.\n\n## Features\n\n- **Persistent Personality**: Maintains a consistent personality across conversations through structured personality files\n- **Dynamic Memory System**: Remembers past conversations and uses them to inform future interactions\n- **Emotional Intelligence**: Tracks and evolves emotional states based on interactions\n- **Natural Conversation**: Engages in human-like dialogue while maintaining character consistency\n\n## Personality Structure\n\nThe AI's personality is maintained through several JSON files in the `my-personality` directory:\n\n- `core-identity.json`: Defines fundamental traits, values, and life philosophy\n- `emotional-framework.json`: Tracks current emotional state and patterns\n- `cognitive-style.json`: Describes thinking and learning patterns\n- `social-dynamics.json`: Outlines communication and relationship styles\n- `interests-values.json`: Lists professional and personal interests\n- `behavioral-patterns.json`: Details daily routines and interaction patterns\n- `memory-growth.json`: Stores conversation history and personal growth\n\n## Memory Management\n\nThe system implements a sophisticated memory management approach:\n\n- **Recent Memory Window**: Maintains a rolling window of the most recent conversations\n- **Memory Compression**: Summarizes older conversations to maintain context while managing size\n- **Core Memories**: Preserves important formative experiences and key learnings\n- **Growth Tracking**: Monitors personal development and current focus areas\n\n## Conversation Features\n\n- **Natural Dialogue**: Engages in human-like conversation while maintaining character\n- **Context Awareness**: Uses recent memories to inform responses\n- **Personality Evolution**: Updates traits based on conversation patterns\n- **Emotional Response**: Maintains and evolves emotional states through interactions\n\n## Setup\n\n1. Clone the repository\n2. Install dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n3. Set up your OpenAI API key in a `.env` file:\n   ```\n   OPENAI_API_KEY=your_api_key_here\n   ```\n\n## Usage\n\nRun the chatbot:\n```bash\npython main.py\n```\n\nThe chatbot will:\n1. Load existing personality files or create new ones\n2. Initialize conversation memory\n3. Begin an interactive chat session\n\n## Personality Files\n\n### Core Identity (`core-identity.json`)\n- Name, age, and profession\n- Core values and life philosophy\n- Personality traits (primary and secondary)\n- Aspirations and identity anchors\n\n### Emotional Framework (`emotional-framework.json`)\n- Current emotional state (mood, energy, stress)\n- Emotional patterns and triggers\n- Coping strategies and emotional goals\n\n### Memory Growth (`memory-growth.json`)\n- Core memories and formative experiences\n- Recent conversation history\n- Growth tracking and learning cycles\n- Current focus areas\n\n## Development\n\nThe system is built with extensibility in mind:\n- New personality traits can be added to existing files\n- Memory management can be adjusted through configuration\n- Conversation patterns can be modified to suit different use cases\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpointlessai%2Fchatbot-memory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpointlessai%2Fchatbot-memory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpointlessai%2Fchatbot-memory/lists"}