Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/lepuz-coder/opengnothia

OpenGnothia is a privacy-focused desktop app that helps you explore your inner world through AI-assisted therapy sessions, journaling, and dream analysis. All your data stays on your device.
https://github.com/lepuz-coder/opengnothia

ai ai-assistant artificial-intelligence chatbot claude-api electron mental-health mental-health-support open-source privacy-first pyschology self-hosted therapy wellbeing wellbeing-app

Last synced: about 2 months ago
JSON representation

OpenGnothia is a privacy-focused desktop app that helps you explore your inner world through AI-assisted therapy sessions, journaling, and dream analysis. All your data stays on your device.

Awesome Lists containing this project

README 

          


  OpenGnothia Logo

  
OpenGnothia


  
"Gnôthi Seautón" — Know Thyself


  
An AI-powered, privacy-first self-therapy desktop application that helps you explore your inner world through therapy sessions, journaling, dream analysis, and more.



  



  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

  [![Version](https://img.shields.io/badge/version-1.5.0-green.svg)](https://github.com/Lepuz-coder/opengnothia/releases)

  [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey.svg)](#getting-started)

  [![Made with Tauri](https://img.shields.io/badge/Made%20with-Tauri%202-FFC131?logo=tauri&logoColor=white)](https://v2.tauri.app)

  [![React](https://img.shields.io/badge/React-19-61DAFB?logo=react&logoColor=white)](https://react.dev)

  [![Rust](https://img.shields.io/badge/Rust-Backend-DEA584?logo=rust&logoColor=white)](https://www.rust-lang.org)



  



  [Website](https://opengnothia.com) · [Download](https://github.com/Lepuz-coder/opengnothia/releases) · [Report Bug](https://github.com/Lepuz-coder/opengnothia/issues) · [Request Feature](https://github.com/Lepuz-coder/opengnothia/issues)










---



## Why OpenGnothia?



Mental health support should be accessible, private, and personalized. OpenGnothia combines the power of modern AI with evidence-based therapeutic approaches to create a self-therapy companion that lives entirely on your device.



- **Your data never leaves your device** — all sessions, journal entries, and insights are stored locally in SQLite

- **Choose your therapeutic approach** — from Psychoanalysis to CBT, Stoicism to Schema Therapy

- **Bring your own AI** — works with Anthropic Claude, OpenAI, or any compatible API endpoint

- **Open source and transparent** — review every line of code that handles your most personal thoughts



> **Note:** OpenGnothia is a self-exploration tool, not a replacement for professional mental health care. If you are in crisis, please reach out to a licensed professional or crisis helpline.



---



## Screenshots





  

    

      Live Therapy Session
Live Therapy Session

    

    

      Dashboard
Dashboard

      AI Therapy Session
AI Therapy Sessions

    

    

      Analyses
Analyses

      AI Insights
AI-Generated Insights

    

    

      Dream Analysis
Dream Analysis

      Therapy Schools
Therapy Schools

    

    

      Therapy Programs
Therapy Programs

      Breathing Exercises
Breathing Exercises

    

    

      Expenses
Expenses

      Settings
Settings

    

  




---



## Demo






[**Interactive Demo — Complete onboarding and start your first session**](https://demo.arcade.software/GyEESVP1uqMY9LT8A8NR?embed&embed_mobile=inline&embed_desktop=inline&show_copy_link=true)






---



## Features



### Redesigned Dashboard

A hero session card surfaces your current or next session, ritual cards track your journal and dream streaks, and an icon-based mood slider lets you log a daily check-in without leaving the home screen.



### AI Therapy Sessions

Engage in meaningful conversations with an AI therapist that adapts to your chosen therapeutic approach. Sessions include real-time streaming responses, session timers, opt-in AI summaries, and session-closure proposals where the AI signals a natural stopping point.



### Clinical Intake Form

Complete an optional 10-question wizard that captures your background, goals, and current stressors — with auto-save as you go. The intake is injected as context into every AI session so therapy feels continuous from the first message.



### In-Session Insights Panel

Capture observations mid-session without breaking flow. Your own notes and AI-proposed insights appear in a side panel; accept the ones that resonate and they're saved to your insights library.



### Journal

Write and reflect on your daily thoughts. Each entry supports mood tagging and optional AI analysis to help you identify patterns and gain deeper understanding of your experiences.



### Dream Analysis

Record your dreams and explore their meaning with AI-assisted interpretation. Build a searchable dream diary to track recurring symbols and themes over time.



### Mood Tracking & Check-ins

Track your daily mood, energy levels, and sleep quality. View your emotional patterns on a calendar with visual mood indicators to understand your mental health trends.



### AI-Generated Insights

Receive AI-generated insights drawn from your sessions and journal entries. Organize them into groups, pin important ones, and revisit them as your self-understanding deepens.



### Breathing Exercises

Access guided breathing techniques to manage stress and anxiety. Multiple breathing patterns are available to suit different needs and moments.



### Therapy Programs

Follow structured therapy programs that guide your self-discovery journey with progressive exercises and reflections.



### Multi-Provider AI Support

Bring your own API key and choose from a wide range of models:

- **Anthropic Claude** — Opus 4.7, Sonnet 4.6, Haiku 4.5 (with extended thinking / adaptive budget)

- **OpenAI** — GPT-5.4 (+ Mini, Pro), GPT-5.3, GPT-4.1, GPT-4o families

- **Custom endpoints** — Connect any OpenAI-compatible API



### Privacy & Security

- All data stored locally in SQLite — no cloud sync, no telemetry

- Biometric lock with Touch ID support (macOS)

- Password protection

- API keys stored only on your device, sent only to the provider you choose



### Multi-Language

Available in English and Turkish, with an extensible internationalization system.



---



## Therapy Schools



OpenGnothia includes carefully crafted therapeutic prompts for six different approaches. Each school shapes how the AI listens, responds, and guides your sessions:



| School | Founded By | Focus |

|--------|-----------|-------|

| **Psychoanalysis / Psychodynamic** | Sigmund Freud | Unconscious processes, past experiences, relational patterns |

| **CBT (Cognitive Behavioral Therapy)** | Aaron Beck | Identifying and changing thought patterns and behaviors |

| **Logotherapy** | Viktor Frankl | Finding meaning in life, even in unavoidable suffering |

| **ACT (Acceptance and Commitment Therapy)** | Steven C. Hayes | Psychological flexibility, values-aligned living |

| **Schema Therapy** | Jeffrey Young | Identifying and transforming early maladaptive schemas |

| **Stoicism (Philosophical Counseling)** | Marcus Aurelius, Epictetus, Seneca | Inner peace, virtue, and rational response to life |



---



## Tech Stack



| Layer | Technology |

|-------|-----------|

| **Frontend** | React 19, TypeScript, TailwindCSS 4 |

| **Build Tool** | Vite 7 |

| **Desktop Runtime** | Tauri 2 |

| **Backend** | Rust |

| **Database** | SQLite (via tauri-plugin-sql) |

| **State Management** | Zustand |

| **Routing** | React Router 7 |

| **Icons** | Lucide React |

| **Markdown** | React Markdown |



---



## Architecture



```

opengnothia/

├── src/                        # React frontend

│   ├── components/             # UI components

│   │   ├── ui/                 # Reusable primitives (Button, Card, Modal, etc.)

│   │   ├── chat/               # Chat interface (messages, input, timer)

│   │   ├── breathing/          # Breathing exercise components

│   │   ├── session/            # Session-related components

│   │   └── onboarding/         # First-run onboarding flow

│   ├── pages/                  # Route pages (Dashboard, Session, Journal, etc.)

│   ├── stores/                 # Zustand state stores

│   ├── services/

│   │   ├── ai/                 # AI provider integration & prompt building

│   │   └── db/                 # SQLite database queries

│   ├── constants/              # Therapy schools, providers, breathing techniques

│   ├── hooks/                  # Custom React hooks

│   ├── i18n/                   # Internationalization (en, tr)

│   ├── types/                  # TypeScript type definitions

│   └── lib/                    # Utility functions

│

├── src-tauri/                  # Tauri / Rust backend

│   ├── src/                    # Rust source (main.rs, lib.rs)

│   ├── migrations/             # SQLite migration files (12 versions)

│   ├── icons/                  # App icons for all platforms

│   ├── Cargo.toml              # Rust dependencies

│   └── tauri.conf.json         # Tauri configuration

│

├── assets/                     # Static assets

│   └── screenshots/            # App screenshots

├── package.json

├── vite.config.ts

└── tsconfig.json

```



**Data Flow:**

```

User ──> React UI ──> Zustand Store ──> Tauri Commands ──> SQLite (local)

                          │

                          └──> AI Service ──> Anthropic / OpenAI / Custom API

```



All data stays on the user's device. The only external communication is with the AI provider of your choice, using your own API key.



---



## Getting Started



### Prerequisites



- [Node.js](https://nodejs.org/) v18+

- [pnpm](https://pnpm.io/)

- [Rust](https://www.rust-lang.org/tools/install)

- [Tauri CLI prerequisites](https://v2.tauri.app/start/prerequisites/)



### Installation



```bash

# Clone the repository

git clone https://github.com/Lepuz-coder/opengnothia.git

cd opengnothia



# Install dependencies

pnpm install



# Run in development mode

pnpm tauri dev



# Build for production

pnpm tauri build

```



### macOS: "App is damaged" Warning



If you download OpenGnothia from GitHub Releases on macOS, you may see a **"OpenGnothia is damaged and can't be opened"** warning. This happens because the app is not signed with an Apple Developer certificate.



To fix this, open Terminal and run **both** commands:



```bash

xattr -cr /Applications/OpenGnothia.app

codesign --force --deep --sign - /Applications/OpenGnothia.app

```



If you downloaded it to a different location:



```bash

xattr -cr ~/Downloads/OpenGnothia.app

codesign --force --deep --sign - ~/Downloads/OpenGnothia.app

```



> **Important:** The `codesign` step is required after `xattr -cr`. Without it, macOS cannot properly track permissions (e.g. microphone access) and may show repeated permission dialogs.



### First Launch



On first launch, the onboarding flow will guide you through:



1. **AI Provider** — Select Anthropic, OpenAI, or a custom endpoint

2. **API Key** — Enter your API key (stored locally, never shared)

3. **Model Selection** — Choose your preferred AI model

4. **Therapy School** — Pick a therapeutic approach that resonates with you

5. **Profile** — Set your name and preferences



You're ready to start your self-therapy journey.



---



## Configuration



All configuration is managed through the in-app Settings page:



- **AI Provider & Model** — Switch providers or models at any time

- **Therapy School** — Change your therapeutic approach between sessions

- **Language** — Toggle between English and Turkish

- **Security** — Enable biometric lock or password protection

- **Extended Thinking** — Enable deeper AI reasoning for supported models (adaptive or budget mode)



---



## Contributing



Contributions are welcome! Whether it's a bug fix, new feature, translation, or documentation improvement, we appreciate your help.



### Development Workflow



1. Fork the repository

2. Create your feature branch (`git checkout -b feature/amazing-feature`)

3. Make your changes

4. Test in development mode (`pnpm tauri dev`)

5. Commit your changes (`git commit -m 'Add amazing feature'`)

6. Push to the branch (`git push origin feature/amazing-feature`)

7. Open a Pull Request



### Areas Where You Can Help



- **New therapy schools** — Add new therapeutic approaches with detailed system prompts

- **Translations** — Add new languages by creating translation files in `src/i18n/`

- **Breathing techniques** — Add new guided breathing patterns

- **UI/UX improvements** — Enhance the interface and user experience

- **Bug fixes** — Check [open issues](https://github.com/Lepuz-coder/opengnothia/issues) for known bugs

- **Documentation** — Improve guides, add examples, and clarify setup steps



## License



This project is licensed under the **MIT License** — see the [LICENSE](LICENSE) file for details.



---



## Acknowledgments



OpenGnothia stands on the shoulders of giants:



- **Sigmund Freud**, **Aaron Beck**, **Viktor Frankl**, **Steven C. Hayes**, **Jeffrey Young**, **Marcus Aurelius**, **Epictetus**, **Seneca** — for the therapeutic frameworks that guide the AI sessions

- [Tauri](https://tauri.app/) — for making native desktop apps with web technologies possible

- [React](https://react.dev/) — for the UI framework

- [Rust](https://www.rust-lang.org/) — for the secure, performant backend

- The open-source community — for making projects like this possible



---





  Built with care for those who seek to know themselves.

  


  If OpenGnothia helps you, consider giving it a star on GitHub.