Freenote

An open-source AI journal app with Markdown support
Visit Freenote App

Report Bug · Request Feature · 中文文档

Freenote is an open-source AI journal app with Markdown support. You can freely record your notes, and with AI assistance, easily search and summarize past entries, enhancing creativity capture and management. All data is stored locally on your device, ensuring privacy and security.

• Markdown Editor: Rich formatting with intuitive shortcuts
• AI Assistant: Search and summarize your notes intelligently
• Privacy First: All data stored locally on your device
• Distraction-Free: Clean interface focused on writing

(back to top)

1. Click on the Journal section to write notes with Markdown
2. Use Markdown shortcuts for formatting:
   • Type # to ###### for headings (H1-H6)
   • Type * or - for bullet lists
   • Type > for blockquotes
   • Select text + Ctrl/Cmd+B for bold, Ctrl/Cmd+I for italic
   • Type ` for inline code, or ``` for code blocks

1. Go to Settings → Add your OpenAI API key
2. Use Chat to ask questions about your notes
3. Search across all entries with AI assistance

Note: AI features require an OpenAI API key

(back to top)

To get a local copy up and running, follow these simple steps.

• Node.js (v18 or higher)
• npm or pnpm

  npm install npm@latest -g
  # or
  npm install -g pnpm

1. Clone the repo

   git clone https://github.com/celerforge/freenote.git

2. Install dependencies

   cd freenote
   pnpm install

3. Create environment configuration

   cp .env.example .env

4. Start the development server

   pnpm dev

You can also run Freenote using Docker:

1. Build the Docker image

   docker build -t freenote .

2. Run the container

   docker run -p 3000:3000 freenote

3. Access the application at http://localhost:3000

(back to top)

• Enhanced AI Tools
  • AI summarization tool for keyword searches with related notes and connections
  • AI-powered knowledge base generation from notes
• Storage code readability optimization
• Note import/export functionality
• Multi-device data synchronization
• Add desktop app using Tauri
• Add tags to notes

See the open issues for a full list of proposed features and known issues.

(back to top)

Contributions make the open source community an amazing place to learn, inspire, and create. Any contributions are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

Distributed under the AGPL-3.0 License. See LICENSE for more information.

(back to top)