Streamystats offers advanced analytics and data visualization for Jellyfin media servers, targeting users seeking deeper insights into their media consumption. It leverages modern frameworks and AI features like embeddings and chat for personalized recommendations and library interaction, enhancing the user experience beyond basic statistics.

How It Works

The service ingests data directly from the Jellyfin API. Core features include a dashboard, user-specific analytics, and library insights. A key differentiator is its AI integration: it uses OpenAI-compatible APIs to generate embeddings for library items, storing them in vectorchord for similarity searches. This powers an AI chat interface and a recommendation engine that suggests content based on watch history using cosine distance, providing explanations for its choices.

Quick Start & Requirements

• Primary install / run command: docker-compose up -d
• Non-default prerequisites and dependencies: Docker, Docker Compose, Jellyfin API access.
• Estimated setup time or resource footprint: Initial library sync can take a significant amount of time, depending on library size.
• Links: Setup wizard guides connection to Jellyfin; no explicit URL for external documentation provided in the README. Version tags are recommended for stability over the :latest Docker image.

Highlighted Details

• AI-powered chat interface with 13 specialized tools, including semantic library search and personalized recommendations.
• Vector embeddings generated via OpenAI-compatible APIs and stored in vectorchord for advanced similarity search.
• Comprehensive dashboard with overview statistics, live sessions, user-specific history, and watch time graphs with advanced filtering.
• Support for multi-server and multi-user configurations.

Maintenance & Community

This is noted as a hobby project, and users should "Don't expect fast development." No specific community links (Discord/Slack) or roadmap details beyond planned features are provided.

Licensing & Compatibility

The README does not specify a software license. This requires clarification for commercial use or integration into closed-source projects.

Limitations & Caveats

As a hobby project, development pace may be slow. The :latest Docker tag may contain breaking changes. The AI chat feature is currently in beta. No explicit mention of supported Jellyfin versions or performance benchmarks.