mindroom 0.0.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

mindroom/tools/lumalabs.py

@@ -0,0 +1,71 @@
+"""Luma Labs tool configuration."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from mindroom.tools_metadata import (
+    ConfigField,
+    SetupType,
+    ToolCategory,
+    ToolStatus,
+    register_tool_with_metadata,
+)
+
+if TYPE_CHECKING:
+    from agno.tools.lumalab import LumaLabTools
+
+
+@register_tool_with_metadata(
+    name="lumalabs",
+    display_name="Luma Labs",
+    description="3D content creation and video generation using Luma AI Dream Machine",
+    category=ToolCategory.DEVELOPMENT,  # others/ category maps to DEVELOPMENT
+    status=ToolStatus.REQUIRES_CONFIG,  # Requires LUMAAI_API_KEY
+    setup_type=SetupType.API_KEY,  # API key authentication
+    icon="FaVideo",  # Video-related icon
+    icon_color="text-purple-600",  # Purple color for AI/ML tools
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="luma_api_...",
+            description="Luma AI API key for authentication (can also be set via LUMAAI_API_KEY env var)",
+        ),
+        # Generation settings
+        ConfigField(
+            name="wait_for_completion",
+            label="Wait for Completion",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Wait for video generation to complete before returning results",
+        ),
+        ConfigField(
+            name="poll_interval",
+            label="Poll Interval",
+            type="number",
+            required=False,
+            default=3,
+            description="Interval in seconds between status checks during video generation",
+        ),
+        ConfigField(
+            name="max_wait_time",
+            label="Max Wait Time",
+            type="number",
+            required=False,
+            default=300,
+            description="Maximum time in seconds to wait for video generation completion",
+        ),
+    ],
+    dependencies=["lumaai"],
+    docs_url="https://docs.agno.com/tools/toolkits/others/lumalabs",
+)
+def lumalabs_tools() -> type[LumaLabTools]:
+    """Return Luma Labs tools for 3D content creation and video generation."""
+    from agno.tools.lumalab import LumaLabTools
+
+    return LumaLabTools

mindroom/tools/mem0.py

@@ -0,0 +1,82 @@
+"""Mem0 Memory tool configuration."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from mindroom.tools_metadata import ConfigField, SetupType, ToolCategory, ToolStatus, register_tool_with_metadata
+
+if TYPE_CHECKING:
+    from agno.tools.mem0 import Mem0Tools
+
+
+@register_tool_with_metadata(
+    name="mem0",
+    display_name="Mem0 Memory",
+    description="Persistent memory system that stores, retrieves, searches, and manages user memories and context",
+    category=ToolCategory.PRODUCTIVITY,  # Database tools → Productivity
+    status=ToolStatus.REQUIRES_CONFIG,  # Requires API key for cloud usage
+    setup_type=SetupType.API_KEY,  # Optional API key for cloud usage
+    icon="Brain",
+    icon_color="text-purple-600",  # Memory/brain theme
+    config_fields=[
+        # Authentication/Connection parameters first
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="mem0_...",
+            description="Mem0 API key for cloud usage (can also be set via MEM0_API_KEY env var)",
+        ),
+        ConfigField(
+            name="org_id",
+            label="Organization ID",
+            type="text",
+            required=False,
+            placeholder="org_123...",
+            description="Organization ID for Mem0 cloud (can also be set via MEM0_ORG_ID env var)",
+        ),
+        ConfigField(
+            name="project_id",
+            label="Project ID",
+            type="text",
+            required=False,
+            placeholder="proj_456...",
+            description="Project ID for Mem0 cloud (can also be set via MEM0_PROJECT_ID env var)",
+        ),
+        # Configuration parameters
+        ConfigField(
+            name="config",
+            label="Local Configuration",
+            type="text",
+            required=False,
+            placeholder='{"vector_store": {"provider": "chroma"}}',
+            description="JSON configuration for self-hosted Mem0 instance (overrides cloud API)",
+        ),
+        ConfigField(
+            name="user_id",
+            label="Default User ID",
+            type="text",
+            required=False,
+            placeholder="user_123",
+            description="Default user ID for memory operations (can be overridden per operation)",
+        ),
+        # Feature parameters
+        ConfigField(
+            name="infer",
+            label="Enable Memory Inference",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable automatic memory inference and extraction from conversations",
+        ),
+    ],
+    dependencies=["mem0ai"],  # Already in pyproject.toml
+    docs_url="https://docs.agno.com/tools/toolkits/database/mem0",
+)
+def mem0_tools() -> type[Mem0Tools]:
+    """Return Mem0 memory tools for persistent memory management."""
+    from agno.tools.mem0 import Mem0Tools
+
+    return Mem0Tools

mindroom/tools/modelslabs.py

@@ -0,0 +1,85 @@
+"""ModelsLabs tool configuration."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from mindroom.tools_metadata import (
+    ConfigField,
+    SetupType,
+    ToolCategory,
+    ToolStatus,
+    register_tool_with_metadata,
+)
+
+if TYPE_CHECKING:
+    from agno.tools.models_labs import ModelsLabTools
+
+
+@register_tool_with_metadata(
+    name="modelslabs",
+    display_name="ModelsLabs",
+    description="AI model marketplace for generating videos, audio, and GIFs from text prompts",
+    category=ToolCategory.DEVELOPMENT,  # From docs URL: /tools/toolkits/others/
+    status=ToolStatus.REQUIRES_CONFIG,  # Requires API key
+    setup_type=SetupType.API_KEY,  # Uses api_key parameter
+    icon="Video",  # React icon for video generation
+    icon_color="text-purple-600",  # Purple color for creative/AI tools
+    config_fields=[
+        # Authentication parameter
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            default=None,
+            placeholder="your-modelslabs-api-key",
+            description="The ModelsLab API key for authentication (can also be set via MODELS_LAB_API_KEY env var)",
+        ),
+        # Media generation parameters
+        ConfigField(
+            name="file_type",
+            label="File Type",
+            type="text",
+            required=False,
+            # The agno default is FileType.MP4, which has value "mp4"
+            default="mp4",
+            placeholder="mp4",
+            description="The type of file to generate (mp4, gif, or mp3)",
+        ),
+        # Timing and completion parameters
+        ConfigField(
+            name="wait_for_completion",
+            label="Wait for Completion",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Whether to wait for the media generation to complete before returning",
+        ),
+        ConfigField(
+            name="add_to_eta",
+            label="Add to ETA",
+            type="number",
+            required=False,
+            default=15,
+            placeholder="15",
+            description="Time in seconds to add to the ETA to account for the time it takes to fetch the media",
+        ),
+        ConfigField(
+            name="max_wait_time",
+            label="Max Wait Time",
+            type="number",
+            required=False,
+            default=60,
+            placeholder="60",
+            description="Maximum time in seconds to wait for the media to be ready",
+        ),
+    ],
+    dependencies=["requests"],  # Already in pyproject.toml
+    docs_url="https://docs.agno.com/tools/toolkits/others/models_labs",
+)
+def modelslabs_tools() -> type[ModelsLabTools]:
+    """Return ModelsLabs tool for AI-powered media generation."""
+    from agno.tools.models_labs import ModelsLabTools
+
+    return ModelsLabTools

mindroom/tools/moviepy_video_tools.py

@@ -0,0 +1,62 @@
+"""MoviePy Video Tools configuration."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from mindroom.tools_metadata import (
+    ConfigField,
+    SetupType,
+    ToolCategory,
+    ToolStatus,
+    register_tool_with_metadata,
+)
+
+if TYPE_CHECKING:
+    from agno.tools.moviepy_video import MoviePyVideoTools
+
+
+@register_tool_with_metadata(
+    name="moviepy_video_tools",
+    display_name="MoviePy Video Tools",
+    description="Process videos, extract audio, generate SRT caption files, and embed rich word-highlighted captions",
+    category=ToolCategory.DEVELOPMENT,  # Derived from docs URL (/others/)
+    status=ToolStatus.AVAILABLE,  # No authentication required
+    setup_type=SetupType.NONE,  # No authentication needed
+    icon="FaVideo",  # React icon name for video
+    icon_color="text-purple-600",  # Purple color for video processing
+    config_fields=[
+        # Video processing features
+        ConfigField(
+            name="process_video",
+            label="Process Video",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable the extract_audio tool for extracting audio tracks from video files",
+        ),
+        ConfigField(
+            name="generate_captions",
+            label="Generate Captions",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable the create_srt tool for saving transcriptions to SRT formatted files",
+        ),
+        ConfigField(
+            name="embed_captions",
+            label="Embed Captions",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable the embed_captions tool for creating videos with word-level highlighted captions",
+        ),
+    ],
+    dependencies=["moviepy"],  # From agno requirements
+    docs_url="https://docs.agno.com/tools/toolkits/others/moviepy",  # URL from llms.txt but WITHOUT .md extension
+)
+def moviepy_video_tools() -> type[MoviePyVideoTools]:
+    """Return MoviePy Video Tools for video processing, audio extraction, and caption generation."""
+    from agno.tools.moviepy_video import MoviePyVideoTools
+
+    return MoviePyVideoTools

mindroom/tools/newspaper4k.py

@@ -0,0 +1,63 @@
+"""Newspaper4k tool configuration."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from mindroom.tools_metadata import (
+    ConfigField,
+    SetupType,
+    ToolCategory,
+    ToolStatus,
+    register_tool_with_metadata,
+)
+
+if TYPE_CHECKING:
+    from agno.tools.newspaper4k import Newspaper4kTools
+
+
+@register_tool_with_metadata(
+    name="newspaper4k",
+    display_name="Newspaper4k",
+    description="Read and extract content from news articles using advanced web scraping",
+    category=ToolCategory.RESEARCH,
+    status=ToolStatus.AVAILABLE,
+    setup_type=SetupType.NONE,
+    icon="FaNewspaper",
+    icon_color="text-blue-600",
+    config_fields=[
+        # Article reading functionality
+        ConfigField(
+            name="read_article",
+            label="Read Article",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable the functionality to read the full content of an article",
+        ),
+        # Content options
+        ConfigField(
+            name="include_summary",
+            label="Include Summary",
+            type="boolean",
+            required=False,
+            default=False,
+            description="Include a summary of the article along with the full content",
+        ),
+        ConfigField(
+            name="article_length",
+            label="Article Length",
+            type="number",
+            required=False,
+            placeholder="5000",
+            description="Maximum length of the article or its summary to be processed or returned",
+        ),
+    ],
+    dependencies=["newspaper4k", "lxml_html_clean"],
+    docs_url="https://docs.agno.com/tools/toolkits/web_scrape/newspaper4k",
+)
+def newspaper4k_tools() -> type[Newspaper4kTools]:
+    """Return Newspaper4k tools for news article extraction."""
+    from agno.tools.newspaper4k import Newspaper4kTools
+
+    return Newspaper4kTools

mindroom/tools/openai.py

@@ -0,0 +1,143 @@
+"""OpenAI tool configuration."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from mindroom.tools_metadata import (
+    ConfigField,
+    SetupType,
+    ToolCategory,
+    ToolStatus,
+    register_tool_with_metadata,
+)
+
+if TYPE_CHECKING:
+    from agno.tools.openai import OpenAITools
+
+
+@register_tool_with_metadata(
+    name="openai",
+    display_name="OpenAI",
+    description="AI-powered tools for transcription, image generation, and speech synthesis",
+    category=ToolCategory.DEVELOPMENT,
+    status=ToolStatus.REQUIRES_CONFIG,
+    setup_type=SetupType.API_KEY,
+    icon="SiOpenai",
+    icon_color="text-green-600",
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="sk-...",
+            description="OpenAI API key (can also be set via OPENAI_API_KEY env var)",
+        ),
+        # Feature toggles
+        ConfigField(
+            name="enable_transcription",
+            label="Enable Transcription",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable audio transcription using Whisper",
+        ),
+        ConfigField(
+            name="enable_image_generation",
+            label="Enable Image Generation",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable image generation using DALL-E",
+        ),
+        ConfigField(
+            name="enable_speech_generation",
+            label="Enable Speech Generation",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable text-to-speech synthesis",
+        ),
+        # Transcription settings
+        ConfigField(
+            name="transcription_model",
+            label="Transcription Model",
+            type="text",
+            required=False,
+            default="whisper-1",
+            placeholder="whisper-1",
+            description="Model to use for audio transcription",
+        ),
+        # Text-to-speech settings
+        ConfigField(
+            name="text_to_speech_voice",
+            label="Text-to-Speech Voice",
+            type="text",
+            required=False,
+            default="alloy",
+            placeholder="alloy",
+            description="Voice to use for speech generation (alloy, echo, fable, onyx, nova, shimmer)",
+        ),
+        ConfigField(
+            name="text_to_speech_model",
+            label="Text-to-Speech Model",
+            type="text",
+            required=False,
+            default="tts-1",
+            placeholder="tts-1",
+            description="Model to use for text-to-speech (tts-1, tts-1-hd)",
+        ),
+        ConfigField(
+            name="text_to_speech_format",
+            label="Text-to-Speech Format",
+            type="text",
+            required=False,
+            default="mp3",
+            placeholder="mp3",
+            description="Audio format for speech generation (mp3, opus, aac, flac, wav, pcm)",
+        ),
+        # Image generation settings
+        ConfigField(
+            name="image_model",
+            label="Image Model",
+            type="text",
+            required=False,
+            default="dall-e-3",
+            placeholder="dall-e-3",
+            description="Model to use for image generation",
+        ),
+        ConfigField(
+            name="image_quality",
+            label="Image Quality",
+            type="text",
+            required=False,
+            placeholder="standard",
+            description="Quality setting for image generation (standard, hd)",
+        ),
+        ConfigField(
+            name="image_size",
+            label="Image Size",
+            type="text",
+            required=False,
+            placeholder="1024x1024",
+            description="Size for generated images (256x256, 512x512, 1024x1024, 1792x1024, 1024x1792)",
+        ),
+        ConfigField(
+            name="image_style",
+            label="Image Style",
+            type="text",
+            required=False,
+            placeholder="vivid",
+            description="Style for generated images (vivid, natural)",
+        ),
+    ],
+    dependencies=["openai"],
+    docs_url="https://docs.agno.com/tools/toolkits/models/openai",
+)
+def openai_tools() -> type[OpenAITools]:
+    """Return OpenAI tools for AI-powered transcription, image generation, and speech synthesis."""
+    from agno.tools.openai import OpenAITools
+
+    return OpenAITools

mindroom/tools/openweather.py

@@ -0,0 +1,89 @@
+"""OpenWeather tool configuration."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from mindroom.tools_metadata import (
+    ConfigField,
+    SetupType,
+    ToolCategory,
+    ToolStatus,
+    register_tool_with_metadata,
+)
+
+if TYPE_CHECKING:
+    from agno.tools.openweather import OpenWeatherTools
+
+
+@register_tool_with_metadata(
+    name="openweather",
+    display_name="OpenWeather",
+    description="Weather data services from OpenWeatherMap API",
+    category=ToolCategory.DEVELOPMENT,  # Based on agno docs structure: /tools/toolkits/others/
+    status=ToolStatus.REQUIRES_CONFIG,  # Requires API key
+    setup_type=SetupType.API_KEY,  # Uses api_key parameter
+    icon="WiDaySunny",  # Weather icon
+    icon_color="text-orange-500",  # Orange sun color
+    config_fields=[
+        # Authentication
+        ConfigField(
+            name="api_key",
+            label="API Key",
+            type="password",
+            required=False,
+            placeholder="your_openweather_api_key",
+            description="OpenWeatherMap API key. If not provided, uses OPENWEATHER_API_KEY env var.",
+        ),
+        # Configuration
+        ConfigField(
+            name="units",
+            label="Units",
+            type="text",
+            required=False,
+            default="metric",
+            placeholder="metric",
+            description="Units of measurement. Options: 'standard', 'metric', 'imperial'.",
+        ),
+        # Feature flags
+        ConfigField(
+            name="current_weather",
+            label="Current Weather",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable current weather function",
+        ),
+        ConfigField(
+            name="forecast",
+            label="Forecast",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable forecast function",
+        ),
+        ConfigField(
+            name="air_pollution",
+            label="Air Pollution",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable air pollution function",
+        ),
+        ConfigField(
+            name="geocoding",
+            label="Geocoding",
+            type="boolean",
+            required=False,
+            default=True,
+            description="Enable geocoding function",
+        ),
+    ],
+    dependencies=["requests"],  # From agno requirements
+    docs_url="https://docs.agno.com/tools/toolkits/others/openweather",  # URL without .md extension
+)
+def openweather_tools() -> type[OpenWeatherTools]:
+    """Return OpenWeather tools for weather data access."""
+    from agno.tools.openweather import OpenWeatherTools
+
+    return OpenWeatherTools

mindroom/tools/oxylabs.py

@@ -0,0 +1,54 @@
+"""Oxylabs tool configuration."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from mindroom.tools_metadata import (
+    ConfigField,
+    SetupType,
+    ToolCategory,
+    ToolStatus,
+    register_tool_with_metadata,
+)
+
+if TYPE_CHECKING:
+    from agno.tools.oxylabs import OxylabsTools
+
+
+@register_tool_with_metadata(
+    name="oxylabs",
+    display_name="Oxylabs",
+    description="Powerful web scraping capabilities including SERP, Amazon product data, and universal web scraping",
+    category=ToolCategory.RESEARCH,  # web_scrape maps to RESEARCH
+    status=ToolStatus.REQUIRES_CONFIG,  # requires username and password
+    setup_type=SetupType.API_KEY,  # uses username/password credentials
+    icon="FaGlobe",
+    icon_color="text-blue-600",  # Web/scraping theme
+    config_fields=[
+        # Authentication credentials
+        ConfigField(
+            name="username",
+            label="Username",
+            type="text",
+            required=False,
+            placeholder="your_oxylabs_username",
+            description="Oxylabs dashboard username (can also be set via OXYLABS_USERNAME env var)",
+        ),
+        ConfigField(
+            name="password",
+            label="Password",
+            type="password",
+            required=False,
+            placeholder="your_oxylabs_password",
+            description="Oxylabs dashboard password (can also be set via OXYLABS_PASSWORD env var)",
+        ),
+    ],
+    dependencies=["oxylabs"],
+    docs_url="https://docs.agno.com/tools/toolkits/web_scrape/oxylabs",
+)
+def oxylabs_tools() -> type[OxylabsTools]:
+    """Return Oxylabs tools for web scraping and data extraction."""
+    from agno.tools.oxylabs import OxylabsTools
+
+    return OxylabsTools

mindroom/tools/pandas.py

@@ -0,0 +1,35 @@
+"""Pandas tools configuration."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from mindroom.tools_metadata import (
+    SetupType,
+    ToolCategory,
+    ToolStatus,
+    register_tool_with_metadata,
+)
+
+if TYPE_CHECKING:
+    from agno.tools.pandas import PandasTools
+
+
+@register_tool_with_metadata(
+    name="pandas",
+    display_name="Pandas",
+    description="Advanced data manipulation and analysis",
+    category=ToolCategory.PRODUCTIVITY,
+    status=ToolStatus.AVAILABLE,
+    setup_type=SetupType.NONE,
+    icon="Database",
+    icon_color="text-blue-600",
+    config_fields=[],
+    dependencies=["pandas"],
+    docs_url="https://docs.agno.com/tools/toolkits/database/pandas",
+)
+def pandas_tools() -> type[PandasTools]:
+    """Return Pandas tools for data manipulation and analysis."""
+    from agno.tools.pandas import PandasTools
+
+    return PandasTools