{"id":50927228,"url":"https://github.com/zanni098/brainiac","last_synced_at":"2026-06-17T00:04:07.974Z","repository":{"id":356037682,"uuid":"1230757862","full_name":"zanni098/brainiac","owner":"zanni098","description":"A flexible research agent that supports custom LLM API integration for deep research with cited sources","archived":false,"fork":false,"pushed_at":"2026-05-06T11:10:10.000Z","size":41,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-06T11:36:32.829Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/zanni098.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":null,"dco":null,"cla":null}},"created_at":"2026-05-06T09:41:11.000Z","updated_at":"2026-05-06T11:10:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zanni098/brainiac","commit_stats":null,"previous_names":["zanni098/brainiac"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/zanni098/brainiac","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zanni098%2Fbrainiac","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zanni098%2Fbrainiac/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zanni098%2Fbrainiac/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zanni098%2Fbrainiac/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zanni098","download_url":"https://codeload.github.com/zanni098/brainiac/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zanni098%2Fbrainiac/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34428198,"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-16T02:00:06.860Z","response_time":126,"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":[],"created_at":"2026-06-17T00:03:56.076Z","updated_at":"2026-06-17T00:04:07.969Z","avatar_url":"https://github.com/zanni098.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Brainiac 🧠\n\nA complete research agent platform with multiple interfaces - GUI, CLI, TUI, and Desktop App. Brainiac performs deep research with cited sources, enabling you to connect any LLM provider (Anthropic, OpenAI, or custom APIs) to generate comprehensive research reports.\n\n![Brainiac](https://img.shields.io/badge/Brainiac-Research%20Agent-gold) ![Node.js](https://img.shields.io/badge/Node.js-18+-green) ![Electron](https://img.shields.io/badge/Electron-28+-blue) ![License](https://img.shields.io/badge/License-MIT-green)\n\n## 🎯 Available Versions\n\n- **GUI Version** - Modern web interface with real-time streaming\n- **CLI Version** - Command-line interface for terminal users\n- **TUI Version** - Rich terminal interface with keyboard navigation\n- **Desktop App** - Native application for Mac, Windows, and Linux\n\n## ✨ Features\n\n### Core Features (All Versions)\n- **Multi-Provider Support**: Anthropic Claude, OpenAI GPT, or any custom LLM API\n- **Deep Research**: Searches Wikipedia, Open Library, recent news, and academic sources\n- **Cited Sources**: Inline citations with numbered references\n- **Custom Configuration**: API endpoints, models, tokens, and system prompts\n- **Research History**: Save and review past research sessions\n- **Export Options**: Markdown, TXT, and JSON formats\n\n### GUI Version Features\n- Real-time streaming responses\n- Beautiful dark-themed interface\n- Research history browser\n- Export to multiple formats\n- Responsive design\n\n### CLI Version Features\n- Full command-line control\n- Batch research capabilities\n- History management\n- Script-friendly output\n- Works on all platforms\n\n### TUI Version Features\n- Rich terminal interface\n- Keyboard shortcuts\n- Visual progress indicators\n- Inline report viewing\n- History navigation\n\n### Desktop App Features\n- Native application experience\n- Offline-ready configuration\n- System tray integration\n- Auto-updates (planned)\n- Cross-platform support\n\n## 🚀 Quick Start\n\n### Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/zanni098/brainiac.git\ncd brainiac\n```\n\n2. Install dependencies:\n```bash\nnpm install\n```\n\n3. Configure your API key:\n```bash\nnpm run cli config\n```\n\n### Running Brainiac\n\n#### GUI Version (Web)\n```bash\nnpm run dev\n```\nOpen http://localhost:5173 in your browser.\n\n#### CLI Version\n```bash\nnpm run cli research \"quantum computing\"\nnpm run cli history\n```\n\n#### TUI Version\n```bash\nnpm run tui\n```\n\n#### Desktop App\n```bash\n# Development\nnpm run electron:dev\n\n# Build for your platform\nnpm run electron:build:mac    # macOS\nnpm run electron:build:win    # Windows\nnpm run electron:build:linux  # Linux\n```\n\nFor detailed installation instructions, see [INSTALL.md](INSTALL.md).\n\n## 📖 Usage Guide\n\n### GUI Version\n\n1. Click the **⚙️ SETTINGS** button to configure your API\n2. Enter a research topic in the search box\n3. Click **RESEARCH →** or press Enter\n4. View the generated report with citations\n5. Use **📚 HISTORY** to review past research\n6. Export reports in MD, TXT, or JSON format\n\n### CLI Version\n\n```bash\n# Research a topic\nbrainiac research \"climate change\"\n\n# Export to file\nbrainiac research \"AI ethics\" -o report.md\n\n# View history\nbrainiac history\n\n# Export specific report\nbrainiac export 1 output.md\n\n# Clear history\nbrainiac history --clear\n```\n\n### TUI Version\n\nKeyboard shortcuts:\n- `Enter`: Research current query\n- `Ctrl+C`: Exit\n- `Ctrl+E`: Export current report\n- `Ctrl+H`: View history\n\n## 🔧 Configuration\n\nAll versions share the same configuration stored in `~/.brainiac/config.json`:\n\n```json\n{\n  \"provider\": \"anthropic\",\n  \"apiUrl\": \"https://api.anthropic.com/v1/messages\",\n  \"apiKey\": \"your-api-key\",\n  \"model\": \"claude-sonnet-4-20250514\",\n  \"maxTokens\": 4096,\n  \"systemPrompt\": \"...\"\n}\n```\n\nConfigure via CLI:\n```bash\nbrainiac config\n```\n\nOr edit the file directly.\n\n## 🔧 API Provider Setup\n\n### Anthropic Claude\n\n```javascript\n{\n  provider: \"anthropic\",\n  apiUrl: \"https://api.anthropic.com/v1/messages\",\n  apiKey: \"sk-ant-...\",\n  model: \"claude-sonnet-4-20250514\",\n  maxTokens: 4096\n}\n```\n\nGet your API key from: https://console.anthropic.com/\n\n### OpenAI GPT\n\n```javascript\n{\n  provider: \"openai\",\n  apiUrl: \"https://api.openai.com/v1/chat/completions\",\n  apiKey: \"sk-...\",\n  model: \"gpt-4\",\n  maxTokens: 4096\n}\n```\n\nGet your API key from: https://platform.openai.com/api-keys\n\n### Custom API (Local Models, Ollama, etc.)\n\n```javascript\n{\n  provider: \"custom\",\n  apiUrl: \"http://localhost:11434/api/chat\",\n  apiKey: \"your-key-or-empty\",\n  model: \"llama2\",\n  maxTokens: 4096\n}\n```\n\n## 📋 Report Structure\n\nBrainiac generates comprehensive reports with these sections:\n\n- **## [Title]**: Descriptive title for the research\n- **### Executive Summary**: Brief overview of key findings\n- **### Background \u0026 Context**: Historical context from Wikipedia\n- **### Recent Developments**: Current developments (last 12 months)\n- **### Key Findings \u0026 Data**: Statistics and data points\n- **### Expert Perspectives**: Quotes and expert opinions\n- **### Books \u0026 Academic Sources**: Relevant literature from Open Library\n- **### Critical Analysis**: Deep dive and balanced perspectives\n- **### Implications \u0026 Future Outlook**: Forward-looking analysis\n- **### References**: Numbered list with full URLs and dates\n\nAll claims are cited inline using superscript numbers `[1][2][3]` with corresponding references at the end.\n\n## 🎨 Customization\n\n### System Prompt\n\nModify the system prompt to change research behavior. The default prompt is comprehensive but you can customize it via:\n\n```bash\nbrainiac config\n```\n\nOr edit `~/.brainiac/config.json` directly.\n\n### Styling (GUI Version)\n\nThe GUI uses inline styles for portability. To customize:\n1. Modify style objects in `gui/brainiac.jsx`\n2. Or extract to a CSS file and update `gui/src/index.css`\n\n## 🔒 Security\n\n- **API keys are stored locally** in `~/.brainiac/config.json` (CLI/TUI) or browser localStorage (GUI)\n- No data is sent to any server other than your configured LLM API\n- Configuration persists between sessions on the same device\n- Clear `~/.brainiac/` directory or browser data to remove credentials\n\n## 🛠️ Development\n\n### Project Structure\n\n```\nbrainiac/\n├── gui/              # Web/GUI version\n│   ├── brainiac.jsx  # Main React component\n│   ├── src/          # React app source\n│   └── index.html    # HTML entry point\n├── cli/              # CLI version\n│   └── index.js      # CLI implementation\n├── tui/              # TUI version\n│   └── index.js      # Terminal UI implementation\n├── electron/         # Desktop app\n│   └── main.js       # Electron main process\n├── package.json      # Dependencies and scripts\n├── vite.config.js    # Vite configuration\n├── README.md         # This file\n├── INSTALL.md        # Detailed installation guide\n└── ABOUT.md          # About documentation\n```\n\n### Adding New API Providers\n\nTo add support for a new LLM provider, extend the `API_ADAPTERS` object in the appropriate version file:\n\n```javascript\nconst API_ADAPTERS = {\n  // ... existing adapters\n  yourProvider: {\n    formatRequest: (config, query) =\u003e ({\n      // Format request for your API\n    }),\n    formatHeaders: (config, apiKey) =\u003e ({\n      // Format headers for your API\n    }),\n    parseResponse: (data) =\u003e {\n      // Parse response (CLI/TUI)\n    },\n    parseStream: (line) =\u003e {\n      // Parse streaming response (GUI)\n    }\n  }\n};\n```\n\n## 🤝 Contributing\n\nContributions are welcome! Areas for improvement:\n\n- Additional API provider adapters (Google Gemini, Cohere, etc.)\n- Export reports to PDF\n- Collaborative research features\n- Mobile app version\n- Internationalization support\n- Plugin system for custom data sources\n\nFeel free to open issues or submit pull requests.\n\n## 📄 License\n\nMIT License - feel free to use this project for personal or commercial purposes.\n\n## 🙏 Acknowledgments\n\n- Original research agent concept\n- Anthropic Claude API\n- OpenAI GPT API\n- React, Vite, and Electron communities\n- Blessed and Commander libraries\n\n## 📞 Support\n\nFor issues, questions, or suggestions:\n- GitHub Issues: https://github.com/zanni098/brainiac/issues\n- Documentation: [INSTALL.md](INSTALL.md), [ABOUT.md](ABOUT.md)\n\n---\n\nMade with ❤️ by [zanni098](https://github.com/zanni098)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzanni098%2Fbrainiac","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzanni098%2Fbrainiac","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzanni098%2Fbrainiac/lists"}