OSINT-mask

An OSINT (Open-Source Intelligence) service that generates detailed factual and psychological profiles of Twitter users using an agentic AI model. This service provides a powerful API to generate detailed factual and psychological profiles of Twitter users. It leverages Groq's compound-beta agentic AI model, which performs its own real-time web searches to gather public data and synthesize the information.

This service does not require a Twitter account or any other API keys besides Groq.

Features

• Agentic AI Core: Uses Groq's compound-beta model, which acts as an autonomous agent to perform OSINT.
• Real-Time Web Search: The AI agent automatically searches the web for the most current and relevant information.
• Deep Profiling: Generates a profile including likely real name, profession, location, and associated public links.
• Personality Insights: Provides a psychological assessment based on the Big Five (OCEAN) personality model.
• Simple & Powerful: A single API call triggers the entire OSINT and analysis workflow.

Setup & Running

The recommended way to run this service is with Docker.

Prerequisites

• Docker
• A Groq API Key

Running with Docker Compose

1. Create the Environment File: Create a .env file by running the following command. Make sure to replace your_groq_api_key_here with your actual Groq API key.

   echo "GROQ_API_KEY='your_groq_api_key_here'" > .env

2. Build and Run the Service:

   docker-compose up --build

   To run the service in the background, use the -d (detached) flag:

   docker-compose up --build -d

The service will be available at http://localhost:8000.

API Usage

Send a POST request to the /twitter-profile endpoint with the username you want to profile.

Example Request

cURL -X POST http://localhost:8000/twitter-profile \
-H "Content-Type: application/json" \
-d '{"username": "elonmusk"}'

Example Response

A successful request will return a JSON object containing a factual_profile and a personality_analysis.

{
    "factual_profile": {
        "real_name": "Elon Reeve Musk",
        "likely_profession": "Entrepreneur, Industrial Designer, Technology Entrepreneur, and Philanthropist",
        "likely_location": "California, USA",
        "associated_links": [
            "https://twitter.com/elonmusk",
            "https://www.tesla.com/",
            "https://www.spacex.com/",
            "https://x.com/"
        ],
        "summary": "Elon Musk is a South African-born American entrepreneur and business magnate. He is the CEO of Tesla, Inc. and SpaceX, and recently acquired Twitter, rebranding it as X.",
        "confidence_score": 0.95
    },
    "personality_analysis": {
        "openness": {
            "score": "High",
            "justification": "Elon Musk is known for his innovative and visionary ideas, often disrupting multiple industries."
        },
        "conscientiousness": {
            "score": "Medium",
            "justification": "While Musk is highly driven and a successful entrepreneur, his management style and handling of projects have been questioned."
        },
        "extraversion": {
            "score": "High",
            "justification": "Musk is a very public figure, active on social media, and known for his charismatic presence."
        },
        "agreeableness": {
            "score": "Low",
            "justification": "Musk has been involved in several controversies and public feuds, indicating lower agreeableness."
        },
        "neuroticism": {
            "score": "Medium",
            "justification": "Musk has faced significant stress and pressure, particularly with his ventures like Tesla and SpaceX, but also shows resilience."
        }
    }
}