{"id":35197838,"url":"https://github.com/bamr87/aieo","last_synced_at":"2026-01-13T21:09:34.076Z","repository":{"id":330934753,"uuid":"1124501854","full_name":"bamr87/aieo","owner":"bamr87","description":"AI Engine Optimization - Optimize content for AI engine citations","archived":false,"fork":false,"pushed_at":"2025-12-29T09:44:43.000Z","size":166,"stargazers_count":0,"open_issues_count":10,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-01T02:49:20.115Z","etag":null,"topics":["ai","ai-engine-optimization","aieo","content-optimization","fastapi","python","react","seo","typescript"],"latest_commit_sha":null,"homepage":null,"language":"Python","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/bamr87.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","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},"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,"thanks_dev":null,"custom":null}},"created_at":"2025-12-29T06:06:41.000Z","updated_at":"2025-12-29T06:24:55.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bamr87/aieo","commit_stats":null,"previous_names":["bamr87/aieo"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/bamr87/aieo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bamr87%2Faieo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bamr87%2Faieo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bamr87%2Faieo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bamr87%2Faieo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bamr87","download_url":"https://codeload.github.com/bamr87/aieo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bamr87%2Faieo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28400972,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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","ai-engine-optimization","aieo","content-optimization","fastapi","python","react","seo","typescript"],"created_at":"2025-12-29T08:15:30.249Z","updated_at":"2026-01-13T21:09:34.071Z","avatar_url":"https://github.com/bamr87.png","language":"Python","readme":"# AIEO - AI Engine Optimization\n\n[![CI](https://github.com/your-username/aieo/workflows/CI/badge.svg)](https://github.com/your-username/aieo/actions)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)\n\n**AIEO** (AI Engine Optimization) is the new SEO. Optimize your content to maximize citations from AI engines like Grok, ChatGPT, Claude, Gemini, and Perplexity.\n\n## 🎯 What is AIEO?\n\nAIEO helps content creators optimize their content to be preferentially cited by AI engines. Instead of optimizing for search engines, optimize for the AI engines that are becoming the primary discovery layer.\n\n### Key Features\n\n- ✅ **Content Auditing** - Get an AIEO score (0-100) with detailed gap analysis\n- ✅ **Pattern Detection** - Identify 10 proven AIEO patterns in your content\n- ✅ **Optimization Suggestions** - AI-powered recommendations to improve citations\n- ✅ **Benchmark Comparison** - See how your content ranks against others\n- ✅ **Web UI** - Beautiful interface for content analysis\n- ✅ **CLI Tool** - Command-line interface for automation\n- ✅ **REST API** - Integrate AIEO into your workflow\n\n## 🚀 Quick Start\n\n## Project Structure\n\n```\naieo/\n├── backend/          # FastAPI backend\n├── frontend/         # React frontend\n├── cli/             # Python CLI tool\n└── docker-compose.yml\n```\n\n## Quick Start\n\n### Automated Installation (Recommended)\n\n**Linux/macOS:**\n```bash\n./scripts/install.sh\n```\n\n**Windows or Cross-platform:**\n```bash\npython scripts/install.py\n```\n\nThe installation script will automatically:\n- Check prerequisites\n- Set up backend, frontend, and CLI\n- Configure environment\n- Start Docker services\n- Run database migrations\n\nSee [INSTALL.md](INSTALL.md) for detailed installation instructions.\n\n### Manual Installation\n\nIf you prefer manual setup, see [INSTALL.md](INSTALL.md) for step-by-step instructions.\n\n### Prerequisites\n\n- Docker and Docker Compose\n- Python 3.9+ (for backend and CLI)\n- Node.js 18+ (for frontend)\n\n### Quick Setup\n\n1. **Run installation script:**\n   ```bash\n   ./scripts/install.sh  # Linux/macOS\n   # OR\n   python scripts/install.py  # Windows/Cross-platform\n   ```\n\n2. **Edit `.env` file and add your API keys:**\n   ```bash\n   # Required:\n   OPENAI_API_KEY=your-openai-api-key\n   # Optional:\n   ANTHROPIC_API_KEY=your-anthropic-api-key\n   ```\n\n3. **Start development servers:**\n   ```bash\n   # Backend (from backend/)\n   cd backend\n   source venv/bin/activate\n   uvicorn app.main:app --reload\n\n   # Frontend (from frontend/) - in a new terminal\n   cd frontend\n   npm run dev\n   ```\n\n4. **Access the application:**\n   - Web UI: http://localhost:5173\n   - API Docs: http://localhost:8000/docs\n\n## Verification\n\nAfter installation, verify everything is set up correctly:\n\n```bash\n./scripts/verify.sh  # Linux/macOS\n# OR\npython scripts/verify.py  # Windows/Cross-platform\n```\n\n## Usage\n\n### CLI\n\n```bash\n# Make sure backend virtual environment is activated\nsource backend/venv/bin/activate  # Linux/macOS\n# OR\nbackend\\venv\\Scripts\\activate  # Windows\n\n# Audit content\naieo audit https://example.com/article\naieo audit --file article.md\n\n# Optimize content\naieo optimize article.md --output optimized.md\n\n# View dashboard\naieo dashboard\n```\n\n### Web UI\n\nVisit http://localhost:5173 to use the web interface.\n\n### API\n\nAPI documentation available at http://localhost:8000/docs\n\n## Development\n\n```bash\n# Run tests\nmake test\n\n# Format code\nmake format\n\n# Lint code\nmake lint\n\n# Clean generated files\nmake clean\n```\n\n## 📚 Documentation\n\n- [Installation Guide](INSTALL.md) - Detailed setup instructions\n- [API Documentation](docs/API.md) - API reference\n- [CLI Documentation](docs/CLI.md) - CLI usage guide\n- [Patterns Guide](docs/PATTERNS.md) - AIEO patterns explained\n- [Architecture](docs/ARCHITECTURE.md) - System design\n- [Development Guide](docs/DEVELOPMENT.md) - Contributing guide\n- [PRD](PRD-aieo.md) - Product requirements document\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n- [Code of Conduct](CODE_OF_CONDUCT.md)\n- [Security Policy](SECURITY.md)\n- [Development Guide](docs/DEVELOPMENT.md)\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- Built with [FastAPI](https://fastapi.tiangolo.com/)\n- Frontend powered by [React](https://react.dev/) and [TypeScript](https://www.typescriptlang.org/)\n- Inspired by the need to optimize for AI-first discovery\n\n## 📞 Support\n\n- 📖 [Documentation](docs/)\n- 🐛 [Issue Tracker](https://github.com/your-username/aieo/issues)\n- 💬 [Discussions](https://github.com/your-username/aieo/discussions)\n\n---\n\n**Made with ❤️ for content creators who want to be cited by AI engines**\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbamr87%2Faieo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbamr87%2Faieo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbamr87%2Faieo/lists"}