AunooAI is an open strategic intelligence platform that automatically collects, analyzes, and organizes security news articles to help researchers and foresight professionals to stay informed without information overload.
- Multisource research, across news, research papers and social media
- Media Bias, Factuality and Credibility ratings
- Relevance Scoring
- Quality Control
- Semantic search and analysis
- Foresight visualizations
- Deep Research Agent
- AI Topic Designer
# 1. Clone the repository
git clone <repository-url>
cd aunoo-ai
# 2. Create virtual environment
python -m venv .venv
source .venv/bin/activate # Linux/Mac
# or: .venv\Scripts\activate # Windows
# 3. Run setup (includes dependencies and database configuration)
python setup.py
# 4. Configure API keys
# Edit .env and add your API keys:
# - OPENAI_API_KEY
# - ANTHROPIC_API_KEY
# - FIRECRAWL_API_KEY
# - etc.
# 5. Start the application
python app/run.pyThe application will be available at: http://localhost:10015
Copy .env.example to .env and configure:
# Server
PORT=10015
DOMAIN=localhost
ENVIRONMENT=development
# Database (configured during setup)
DB_TYPE=sqlite # or postgresql
# AI Providers (REQUIRED)
OPENAI_API_KEY=your_key_here
ANTHROPIC_API_KEY=your_key_here
# Data Sources
NEWSAPI_KEY=your_key_here
FIRECRAWL_API_KEY=your_key_here
# Optional Services
ELEVENLABS_API_KEY=your_key_hereThe setup script (python setup.py) will prompt you to setup a database
PostgreSQL
- Production-grade database
- Better for concurrent users (50+)
- Automatic installation and configuration
For manual PostgreSQL setup:
python scripts/setup_postgresql.pypython app/run.py- Auto-reload enabled
- Runs on port 10015 (configurable via PORT env var)
- SSL certificate auto-detection
export ENVIRONMENT=production
export DISABLE_SSL=true # If behind reverse proxy
python app/run.py# Development
docker-compose up aunooai-dev
# Production
docker-compose up aunooai-prod --profile prod# Run database migrations
alembic upgrade head
# Create new migration
alembic revision --autogenerate -m "Description"# Analyze database
python app/analyze_db.py
# Inspect schema
python app/utils/inspect_db.py
# Create fresh database
python app/utils/create_new_db.py# Install dependencies
pip install -r requirements.txt
# Run tests
pytest
# Database analysis
python app/analyze_db.py
# Reindex vector store
python scripts/reindex_chromadb.py
# Initialize defaults
python scripts/init_defaults.pyOnce running, visit:
- Swagger UI: http://localhost:10015/docs
- ReDoc: http://localhost:10015/redoc
FastAPI Application
- Factory pattern:
app.core.app_factory.create_app() - Lifespan management for startup/shutdown
- Middleware: HTTPS redirect, sessions, CORS
Database Layer
- SQLAlchemy ORM with async support
- Dual support: PostgreSQL
- Connection pooling and query optimization
- Vector embeddings via PGVector
Data Collection
- Factory pattern for collectors
- Sources: NewsAPI, ArXiv, Bluesky
- Scheduled and on-demand collection
AI Integration
- Multi-provider: OpenAI, Anthropic, LiteLLM
- Streaming responses
- Token counting and cost tracking
Authentication
- JWT-based sessions
- OAuth integration (Google, GitHub, etc.)
- Session middleware
Edit .env:
# Light load (<10 users)
DB_POOL_SIZE=10
DB_MAX_OVERFLOW=5
# Medium load (10-50 users)
DB_POOL_SIZE=20
DB_MAX_OVERFLOW=10
# Heavy load (50+ users)
DB_POOL_SIZE=50
DB_MAX_OVERFLOW=20Place certificates in project root:
cert.pem
key.pemOr configure paths in .env:
CERT_PATH=/path/to/cert.pem
KEY_PATH=/path/to/key.pemTo disable SSL (e.g., behind nginx):
DISABLE_SSL=trueThe application checks database connectivity on startup:
python app/run.pyCommon errors:
❌ Missing PostgreSQL dependencies
pip install asyncpg psycopg2-binary❌ Failed to connect to PostgreSQL
# Check PostgreSQL is running
sudo systemctl status postgresql
# Check credentials in .env
DB_HOST=localhost
DB_PORT=5432
DB_NAME=aunoo_db
DB_USER=aunoo_user
DB_PASSWORD=your_password❌ Port already in use
# Change port in .env
PORT=10016
# Or kill existing process
lsof -ti :10015 | xargs kill -9Edit .env and add required keys:
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...Ensure virtual environment is activated:
source .venv/bin/activate # Linux/Mac
.venv\Scripts\activate # Windows
# Reinstall dependencies
pip install -r requirements.txt- Follow PEP 8
- Use type hints where possible
- Document complex functions
- Write tests for new features
- Create feature branch
- Make changes with clear commits
- Run tests
- Update documentation
- Submit PR with description
- Framework: FastAPI 0.68+
- Database: PostgreSQL with SQLAlchemy
- Vector Store: PGVector
- AI/LLM: OpenAI, Anthropic, LiteLLM
- NLP: spaCy, NLTK, BERTopic
- Templates: Jinja2
- Server: Uvicorn (ASGI)
- Auth: JWT, OAuth (Authlib)
- Visualization: Plotly, Matplotlib
Minimum:
- Python 3.12+
- 2GB RAM
- 5GB disk space
Recommended:
- Python 3.12+
- 4GB+ RAM
- 10GB+ disk space
- PostgreSQL 14+
[Your License Here]
For issues and questions:
- GitHub Issues: [Repository Issues]
- Documentation:
docs/directory - Setup Help: Run
python setup.pyfor guided setup
# Setup
python setup.py
# Start application
python app/run.py
# PostgreSQL setup
python scripts/setup_postgresql.py
# Database migrations
alembic upgrade head
# Reindex vectors
python scripts/reindex_chromadb.pyAunoo AI Platform is licensed under the Business Source License 1.1.
- ✅ Free to use for internal business purposes, development, testing, and research
- ✅ Free to modify and contribute improvements back to the project
- ✅ Free to integrate into non-competing products
- ❌ Cannot offer as a competing hosted/managed AI news intelligence service
- ❌ Cannot white-label and resell as your own product
- 🔄 Converts to Apache 2.0 on 2028-11-21 (fully open source after 4 years)
For commercial licensing or to use Aunoo AI in a competing service, contact: licensing@aunoo.ai
See LICENSE.md for full terms.
Version: 1.0.0 Last Updated: 2024-11-21 Copyright: © 2024-present Aunoo Ltd. All rights reserved.
