Getting Started in 5 Minutes

What is Aunoo AI?

Aunoo AI is an open strategic intelligence platform that automatically collects, analyzes, and organizes news articles and research reports.

First-Time Setup

The simplest way to install Aunoo for self-hosting is using Docker

1. Download Deployment Files

Windows (PowerShell):

mkdir aunooai 
cd aunooai
Invoke-WebRequest -Uri 
"https://raw.githubusercontent.com/AuNooAI/AunooAI/refs/heads/main/docker-compose.yml" 
-OutFile "docker-compose.yml"

TIP: Make sure you have Docker Desktop running, or you will get an error

Linux:

mkdir aunooai && cd aunooai

curl -O https://raw.githubusercontent.com/AuNooAI/AunooAI/refs/heads/main/docker-compose.yml

2. Start AunooAI

docker-compose up -d

Wait 30-60 seconds for containers to start.

---

3. Access & Configure

Open browser: http://localhost:10001 Default Login:

• Username: admin

• Password: admin123

---

4. Configure API Keys

You need API keys for three services:

Don't have keys yet? Get them from:

• LLM - OpenAI: https://platform.openai.com/api-keys

• News Feed - The NewsAPI: https://www.thenewsapi.com/register

• Scraper - Firecrawl: https://firecrawl.dev

How to add keys:

1. AI-guided Topic Setup

2. Paste your API keys in Step 1

3. Click Test and then Save on each

---

5. Set Up Your First Topic

Topics tell Aunoo what to monitor. Examples: "How strong is the cloud repatriation movement?", "What is APT28 up to?", "How close are we to Quantum Advantage"?

Using the wizard:

1. Still in AI-guided Topic Setup, go to Step 2

2. Enter a topic name: "APT Groups" or "Ransomware Trends"

3. Describe what you want to monitor

4. AI suggests suitable Future Signals, essentially possible scenarios, and suitable categories to break down your topic. When you are happy with the selection, go to Step 3.

1. AI suggests keywords to collect news for your topic automatically

1. Review keywords in Step 3, click Save

Done! Aunoo will now monitor news for your topic.

---

Your First Actions

Start Collecting Intelligence

Automated collection (ongoing):

1. Go to Gather → Keyword Alerts

2. Click Auto-Collect button

   
3. Enable auto-collection

4. Select the LLM you want to use for automated processing

5. Set check interval to 24 hours

6. Make sure everything is configured for full automation

   1. Enable Auto-collection every 24 hours

   2. Search across articles for a maximum of the past 7 days

   3. Maximum daily API requests 100

   4. Whichever News API key was added during onboarding will be activated

   5. Articles will be scored for at least medium relevance.

   6. Article output will be quality assessed to ensure we don’t save CAPTCHA, errors or other bad data to the topic dataset.

7. Click Save

Now Aunoo will automatically search for articles every 24 hours.

Manual submission (immediate):

1. Go to Gather → Submit Articles

2. Paste up to 50 article URLs (one per line)

3. Click Analyze Articles

4. Click Save All Articles

---

View Your Intelligence

Explore View - Your main workspace:

1. Click Explore in the sidebar

2. See all collected articles

1. Use filters to narrow by topic, date, source

2. Drill down into topics by asking Auspex, the AI Futurist.

---

What's Next?

Add More Topics (5 minutes)

1. Go to Settings → AI-guided Topic Setup

2. Repeat Step 2-3 for each new topic

3. Typical setup: 5-10 topics covering your threat landscape

Configure Keywords (10 minutes)

1. Go to Gather → Manage Keywords

2. Review auto-generated keyword groups

3. Add specific threat actors, malware names, CVE IDs

4. Enable/disable groups as needed

---

Common Questions

Q: How do I know if it's working?

• Go to Operations HQ. Check "Articles Today" count. If > 0, it's collecting.

Q: I'm not seeing any articles

• Check Operations HQ → System Health is HEALTHY

• Verify API keys in Settings → App Configuration → Providers

• Try manual submission first to test the pipeline

Q: Too many irrelevant articles

• Go to Gather → Auto-Collect

• Increase "Relevance Threshold" to 70-80

• Refine keywords to be more specific

Q: Where do I see collected articles?

• Explore → Article Investigator shows everything. Use filters to narrow down.

Q: How do I brief my team?

• Explore → Six Articles → Click Write → Export as PDF/Markdown

---

Quick Navigation

I want to...	Go here...
Add articles manually	Gather → Submit Articles
See what was collected	Gather → Keyword Alerts
Analyze my intelligence	Explore → Article Investigator
Brief executives	Explore → Six Articles
Find patterns/trends	Explore → Narrative Explorer
Add API keys	Settings → App Configuration
Create new topics	Settings → AI-guided Topic Setup
Check system health	Operations HQ