{"id":50788039,"url":"https://github.com/fawredd/fawredd-thoughts-assistant","last_synced_at":"2026-06-12T09:30:41.799Z","repository":{"id":352740217,"uuid":"1216345954","full_name":"fawredd/fawredd-thoughts-assistant","owner":"fawredd","description":"An AI-powered journaling companion designed for longitudinal memory and reflective coaching. Fawredd Thoughts helps users capture their daily thoughts, while an AI \"State Architect\" maintains a compressed \"Life Snapshot\" to track goals, problems, and social circles over time.","archived":false,"fork":false,"pushed_at":"2026-05-27T00:09:38.000Z","size":729,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-27T02:13:24.418Z","etag":null,"topics":["ai-agents","coaching-platform","rag-pipeline"],"latest_commit_sha":null,"homepage":"https://fawredd-thoughts-assistant.vercel.app","language":"TypeScript","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/fawredd.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-20T20:13:39.000Z","updated_at":"2026-05-27T00:09:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/fawredd/fawredd-thoughts-assistant","commit_stats":null,"previous_names":["fawredd/fawredd-thoughts-assistant"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fawredd/fawredd-thoughts-assistant","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fawredd%2Ffawredd-thoughts-assistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fawredd%2Ffawredd-thoughts-assistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fawredd%2Ffawredd-thoughts-assistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fawredd%2Ffawredd-thoughts-assistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fawredd","download_url":"https://codeload.github.com/fawredd/fawredd-thoughts-assistant/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fawredd%2Ffawredd-thoughts-assistant/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34238710,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-12T02:00:06.859Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-agents","coaching-platform","rag-pipeline"],"created_at":"2026-06-12T09:30:41.266Z","updated_at":"2026-06-12T09:30:41.792Z","avatar_url":"https://github.com/fawredd.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Fawredd Thoughts Assistant\n\nAn AI-powered journaling companion designed for longitudinal memory and reflective coaching. Fawredd Thoughts helps users capture their daily thoughts, while an AI \"State Architect\" maintains a compressed \"Life Snapshot\" to track goals, problems, and social circles over time.\n\n## 🚀 Features\n\n- **Deep Journaling**: A peaceful, \"Calm Minimal\" interface for capturing thoughts and reflections.\n- **Hybrid Memory System (RAG + Narrative State)**: Utilizes pgvector for semantic search of past entries alongside a continuous \"Life Snapshot\" for longitudinal memory.\n- **Active Socratic AI Persona**: The AI Psychologist acts as an analytical clinical partner, providing real-time reflective coaching through critical inquiry and constructive confrontation.\n- **Multi-Language Support**: Seamless UI toggle and dynamic AI response adaptation for both English and Spanish.\n- **Life Snapshot**: An automated summary of your current life state, tracking goals, psychological patterns, defense mechanisms, and social circles.\n- **Secure \u0026 Encrypted**: All journal entries, AI-generated insights, and life snapshots are encrypted at rest in the database.\n\n## 🛠 Tech Stack\n\n- **Framework**: [Next.js 15+](https://nextjs.org/) (App Router)\n- **Authentication**: [Clerk](https://clerk.com/)\n- **Database**: [Neon](https://neon.tech/) (PostgreSQL)\n- **ORM**: [Drizzle ORM](https://orm.drizzle.team/)\n- **AI Engine**: [Vercel AI SDK](https://sdk.vercel.ai/) with Google Gemini Models\n- **Styling**: Tailwind CSS \u0026 Shadcn UI\n- **Deployment**: Vercel\n\n## 🏗 Architecture\n\nThe application follows a specialized AI pipeline utilizing a multi-agent framework:\n1. **User Input**: User submits a journal entry.\n2. **RAG Retrieval**: The system queries pgvector to retrieve semantically relevant past entries to inform the context.\n3. **State Architect**: A dedicated agent (Gemini) updates the user's \"Life Snapshot\" JSON based on the new entry and previous state.\n4. **Psychologist Agent**: Another agent provides a reflective response streamed seamlessly via Server Actions, using the updated snapshot and RAG context.\n5. **Encryption Layer**: Data is encrypted before being stored in the database to ensure privacy.\n\n## 🚦 Getting Started\n\n### Prerequisites\n\n- Node.js 18+ and pnpm\n- Clerk Account\n- Neon Database (PostgreSQL)\n- Google AI (Gemini) API Key\n\n### Installation\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/your-username/fawredd-thoughts-assistant.git\n   cd fawredd-thoughts-assistant\n   ```\n\n2. Install dependencies:\n   ```bash\n   pnpm install\n   ```\n\n3. Configure environment variables:\n   Create a `.env.local` file based on `.env.local.example`.\n\n4. Run the development server:\n   ```bash\n   pnpm dev\n   ```\n\n5. Open [http://localhost:3000](http://localhost:3000) in your browser.\n\n## 🔒 Security\n\nWe take privacy seriously. All sensitive data is encrypted using industry-standard encryption before being stored. No raw journal entries are stored in plain text.\n\n## 📜 License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffawredd%2Ffawredd-thoughts-assistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffawredd%2Ffawredd-thoughts-assistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffawredd%2Ffawredd-thoughts-assistant/lists"}