{"id":25898140,"url":"https://github.com/different-ai/note-companion","last_synced_at":"2025-05-15T12:06:45.664Z","repository":{"id":193945537,"uuid":"689765175","full_name":"different-ai/note-companion","owner":"different-ai","description":"Note Companion: AI assistant for Obsidian that goes beyond just a chat. (prev File Organizer 2000)","archived":false,"fork":false,"pushed_at":"2025-05-12T19:21:50.000Z","size":160261,"stargazers_count":642,"open_issues_count":33,"forks_count":100,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-05-12T20:33:48.595Z","etag":null,"topics":["gpt","obsidian","ocr"],"latest_commit_sha":null,"homepage":"https://notecompanion.ai","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/different-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"custom":["https://dub.sh/support-fo2k"]}},"created_at":"2023-09-10T20:33:20.000Z","updated_at":"2025-05-12T19:15:25.000Z","dependencies_parsed_at":"2023-12-12T11:39:34.987Z","dependency_job_id":"c67b77bf-2b7f-4ba3-92ce-57ed14ae2aea","html_url":"https://github.com/different-ai/note-companion","commit_stats":null,"previous_names":["different-ai/obsidian-ml","different-ai/gpt-file-organizer","different-ai/note-companion"],"tags_count":383,"template":true,"template_full_name":"obsidianmd/obsidian-sample-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/different-ai%2Fnote-companion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/different-ai%2Fnote-companion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/different-ai%2Fnote-companion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/different-ai%2Fnote-companion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/different-ai","download_url":"https://codeload.github.com/different-ai/note-companion/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254337613,"owners_count":22054253,"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":["gpt","obsidian","ocr"],"created_at":"2025-03-03T00:17:09.649Z","updated_at":"2025-05-15T12:06:40.653Z","avatar_url":"https://github.com/different-ai.png","language":"TypeScript","funding_links":["https://dub.sh/support-fo2k"],"categories":["TypeScript"],"sub_categories":[],"readme":"# Note Companion AI (prev. File Organizer 2000)\n\nNote Companion is an AI-powered Obsidian plugin that automatically organizes and formats your notes—so you don't have to.\n\n\u003cp\u003e\n  \u003ca href=\"https://notecompanion.ai/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Try-Note%20Companion-7852ee?style=flat\u0026logoColor=white\" alt=\"Try Note Companion\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://youtube.com/playlist?list=PLgRcC-DFR5jcwwg0Dr3gNZrkZxkztraKE\u0026si=ZCn2ndFz-zN2cfML\"\u003e\u003cimg src=\"https://img.shields.io/youtube/channel/subscribers/UCd24YzGlvtIG4DYD3zlYLwg?label=YouTube\u0026color=34d399\u0026style=flat\u0026logo=youtube\u0026logoColor=white\" alt=\"YouTube Subscribers\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## 🌟 Features\n\n- 🗂️ **Organizing Suggestions**: Get AI-driven suggestions for folders, tags, filenames, and more.\n- 🎛️ **Custom Format AI Prompts**: Save and apply your own AI prompts for consistency.\n- 📁 **Automated Workflows**: Streamline your file management and formatting tasks.\n- 📖 **Handwritten Note Digitization**: Convert handwritten notes into searchable digital text.\n- 🔊 **Audio Transcription**: Easily transcribe and organize audio files.\n- ✂️ **Atomic Note Generation**: Break down larger notes into smaller, more focused ones.\n- 🎥 **YouTube Summaries**: Quickly generate summaries for YouTube videos.\n- 💬 **Context-Aware AI Chat**: Use AI to chat with multiple notes in context.\n\n\n![Group 39904](https://github.com/user-attachments/assets/ccb7203f-a1dc-45e9-8fb0-6c6b986bf6aa)\n![Group 39905](https://github.com/user-attachments/assets/2b7334b3-33f3-414e-9e2e-cc7720f17f68)\n![Group 39906](https://github.com/user-attachments/assets/389d1f1d-19c8-4a9b-adfa-eeba86df0aff)\n![Group 39907](https://github.com/user-attachments/assets/591d7370-777c-418b-9970-f6809437c2de)\n![Group 39908](https://github.com/user-attachments/assets/07b0a7b5-1da5-4f9b-8cc3-dc4ab52f1338)\n\n---\n\n## 🗄️ Key Use Cases\n\n### Smart Vault Management\nTransform your Obsidian vault into an intelligent knowledge base:\n1. **Context-Aware Organization**: AI suggests tags, folders, and filenames based on content.\n2. **Powerful Search**: Natural language search across files, including YouTube transcripts.\n3. **Automation Tools**:\n   - `LastModifiedHandler`: Track and organize recently modified files.\n   - `ScreenpipeHandler`: Monitor daily activities.\n   - `ExecuteActionsHandler`: Automate repetitive tasks.\n\n### Handwritten Notes Digitization\n- **Advanced OCR Integration**: Convert handwritten notes and diagrams into digital text.\n- **Batch Processing**: Automate organization for multiple notes at once.\n- **Diagram Recognition**: Preserve and process hand-drawn diagrams.\n\n### Intelligent Meeting Notes\n- **Granola-Style Notes**: Automatically create structured and actionable meeting notes.\n- **Smart Transcript Integration**: Merge meeting transcripts with existing notes.\n- **Customizable Templates**: Ensure consistent formatting for all notes.\n\n---\n\n## 🚀 Getting Started\n\nChoose your preferred setup:\n\n### A. Cloud Subscription\n1. Access our managed service with all features included\n2. No setup required - just activate your license key\n3. Regular updates and new features\n\n### B. Self-Hosted Solution\n1. Run your own instance with full control\n2. Use your preferred AI models\n3. Complete privacy with local processing\n\n1. Run the server\n   For Linux/macOS:\n   ```sh\n   cd packages/web \u0026\u0026 pnpm build:self-host \u0026\u0026 pnpm start\n   ```\n   And make sure you have your `OPENAI_API_KEY` variable set up in your `.env.local` file inside the `packages/web` directory. If you want to use Amazon Bedrock models, you'll also need to configure AWS credentials (`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_REGION`).\n   For Windows (PowerShell):\n   ```sh\n   cd packages/web; pnpm build:self-host; pnpm start\n   ```\n   And make sure you have your `OPENAI_API_KEY` variable set up in your `.env.local` file inside the `packages/web` directory.\n2. Enable self-hosted mode in plugin settings:\n   \u003cimg width=\"707\" alt=\"Screenshot 2024-04-13 at 07 16 21\" src=\"https://github.com/different-ai/file-organizer-2000/assets/11430621/ca2222c9-cb8d-4d15-8459-2da4c9662f24\"\u003e\n### C. Development Setup\nThis is a monorepo using pnpm workspaces and Turborepo. To get started:\n1. Install dependencies:\n   ```sh\n   pnpm install\n   ```\n2. Build all packages:\n   ```sh\n   pnpm build\n   ```\n3. Development commands:\n   - Start web development server: `pnpm --filter web dev`\n   - Build plugin: `pnpm --filter plugin build`\n   - Build audio server: `pnpm --filter audio-server build`\n   - **Mobile App (Expo):**\n     - Navigate to the mobile package: `cd packages/mobile`\n     - Install dependencies: `pnpm install` (run inside `packages/mobile`)\n     - Run Android: `pnpm android` (run inside `packages/mobile`)\n     - Run iOS: `pnpm ios` (run inside `packages/mobile`)\n     - Start development server: `pnpm start` (run inside `packages/mobile`)\n\nThe project consists of the following packages:\n- `packages/plugin`: The Obsidian plugin\n- `packages/web`: The web application (Next.js)\n- `packages/mobile`: The mobile application (React Native/Expo)\n- `packages/audio-server`: Audio transcription server\n- `packages/shared`: Shared utilities and types\n\n**Mobile Development Bounty:** We are offering $50 to the first person who can refactor the mobile setup to allow building and running *perfectly* directly from the monorepo root (e.g., `pnpm run android` from the top level instead of having to `cd` into `packages/mobile`). This likely involves adjusting `turbo.json` and potentially Expo configurations.\n\nFor the tech-savvies who would like to play around with different models, there is a promptfoo.yaml file in the project including examples with local LLMs.\nSee link for more info: https://promptfoo.dev/docs/configuration/guide/\n\n\n\n## 📱 Mobile Integration\n\nSeamlessly integrate with your mobile workflow:\n- iOS Shortcut for sending Apple Notes to Obsidian\n- Voice memo support for instant meeting notes\n- Cloud sync compatibility (works great with iCloud)\n\n## iOS shortcut to send Apple Notes and Audios to Obsidian\nThe iOS shortcut below makes it easy for you to easily work from your phone with this plugin.\nhttps://www.icloud.com/shortcuts/06915768862848fb9711f2f19b6405e2\nhow to set it up: https://youtu.be/zWJgIRlDWkk?si=HSeOUKaMfJvaLtKI\n\nNotes:\n- It works when your vault is on a cloud drive. I use it with iCloud and works great. Doesn't work with OneDrive last time I tested.\n- Currently only works if your iOS is in English. But if you reach out on discord I can help you set it up in your language.\n\n\n## 🛠️ Advanced Features\n\n### Custom AI Templates\nCreate powerful automation workflows:\n- Define custom processing rules\n- Set up automatic file naming conventions\n- Configure content formatting templates\n\n### Multi-Modal Support\nProcess various types of content:\n- Audio transcription\n- Image OCR\n- PDF text extraction\n- YouTube video transcripts\n\n\n\n## Tips and Tricks\n\n[![Thumbnail (2)](https://github.com/different-ai/file-organizer-2000/assets/11430621/1b2c524b-11bc-484d-9255-4699783303bf)](https://youtube.com/playlist?list=PLgRcC-DFR5jcwwg0Dr3gNZrkZxkztraKE\u0026si=FozzANIO6i8XI_x8)\n\n## How to use\n\n### A. AI Organizer\n\nGet suggestions and choose what to apply with the Assistant view. Here's how to use it:\n\n1. Click on the Assistant View Icon or set up the \"Show Assistant\" hotkey to open the Sidebar\n2. Select any of your files and choose which changes to apply\n\n\u003cimg width=\"1277\" alt=\"Screenshot 2024-05-24 at 11 42 17 PM\" src=\"https://github.com/different-ai/file-organizer-2000/assets/46509400/dc06a61f-64d0-4e10-898d-3e0330004e94\"\u003e\n\n### B. AI Inbox\n\nAuto-organize with the AI Inbox.\n\nWe recommend the AI Assistant view for more control. But the AI Inbox can be handy as well. Simply move any of your files to the \"Inbox\" folder and the plugin will automatically move it to the folder it belongs. Additional configuration can also be specified within the plugin settings (e.g. auto-tagging, auto-formatting).\n\nMove your unorganized files into `_NoteCompanion/Inbox`\n\n![image](https://github.com/different-ai/file-organizer-2000/assets/11430621/295038f0-170c-456e-8e0a-e89c31719b95)\n\nIt takes a sec, and then renames, and organizes your file.\n\n![image](https://github.com/different-ai/file-organizer-2000/assets/11430621/f9fd716f-6ada-45c4-bd59-a4efcd79b0e5)\n\nSee plugin settings to customize the changes AI Inbox applies to your files.\n\n### C. Create custom AI Templates\n\nGive instructions for the AI to format and modify your files.\n\nSee video: https://www.youtube.com/watch?v=rommuUXRgUw\u0026t=17s\n\n### D. Misc\n\nTo use llama 3.2 with the ai chat, install Ollama + llama 3.2 and check this setting in the plugin:\n\n\u003cimg width=\"751\" alt=\"Screenshot 2024-10-26 at 7 34 18 PM\" src=\"https://github.com/user-attachments/assets/95add737-9cd5-4cb4-a360-ff5fc95ebfa7\"\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdifferent-ai%2Fnote-companion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdifferent-ai%2Fnote-companion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdifferent-ai%2Fnote-companion/lists"}