atlas-chat 0.1.0__py3-none-any.whl

atlas_chat-0.1.0.data/data/config/defaults/help-config.json

@@ -0,0 +1,198 @@
+{
+  "title": "Help & Documentation",
+  "sections": [
+    {
+      "id": "quick-start",
+      "type": "section",
+      "title": "Quick Start",
+      "icon": "zap",
+      "iconColor": "blue-400",
+      "description": "Welcome to the Chat UI! This application provides an advanced chat interface with AI models, enhanced by powerful tools and data sources.",
+      "layout": "cards-grid",
+      "cards": [
+        {
+          "title": "Start a New Chat",
+          "content": "Click \"New Chat\" button or press Ctrl+Alt+N",
+          "hasKeyboard": true,
+          "keyboardShortcut": "Ctrl+Alt+N"
+        },
+        {
+          "title": "Access Tools",
+          "content": "Click the Settings icon in the header to open the tools panel",
+          "hasIcon": true,
+          "iconName": "settings"
+        }
+      ]
+    },
+    {
+      "id": "core-features",
+      "type": "section", 
+      "title": "Core Features",
+      "icon": "message-square",
+      "iconColor": "green-400",
+      "layout": "feature-list",
+      "features": [
+        {
+          "title": "RAG (Retrieval-Augmented Generation)",
+          "icon": "database",
+          "iconColor": "blue-400",
+          "borderColor": "blue-400",
+          "description": "Connect your chats to external data sources for enhanced, context-aware responses.",
+          "bullets": [
+            "Click the menu icon to open data sources panel",
+            "Select which documents/databases to include in your conversation", 
+            "Toggle \"RAG Only\" mode to query only your documents without LLM processing",
+            "View source attribution to see which documents informed the response"
+          ]
+        },
+        {
+          "title": "Tools & MCP Servers",
+          "icon": "settings",
+          "iconColor": "green-400",
+          "borderColor": "green-400",
+          "description": "Extend AI capabilities with specialized tools through Model Context Protocol (MCP) servers.",
+          "bullets": [
+            "Click the Settings icon to view available tools",
+            "Built-in tools include file operations, calculations, and UI demos",
+            "Tools can create interactive content in the Canvas panel",
+            "Select specific tools in the marketplace for personalized experience"
+          ]
+        },
+        {
+          "title": "MCP Store/Marketplace",
+          "icon": "store",
+          "iconColor": "purple-400", 
+          "borderColor": "purple-400",
+          "description": "Browse and select MCP servers that provide different capabilities.",
+          "bullets": [
+            "Navigate to /marketplace to browse available servers",
+            "Select which MCP servers you want to use in your chats",
+            "Each server provides specific tools and functionalities",
+            "Your selections are saved and persist across sessions"
+          ]
+        }
+      ]
+    },
+    {
+      "id": "tips-best-practices",
+      "type": "section",
+      "title": "Tips & Best Practices", 
+      "icon": "alert-triangle",
+      "iconColor": "yellow-400",
+      "layout": "tip-cards",
+      "tips": [
+        {
+          "title": "Starting Fresh Conversations",
+          "content": "For best results, start a new chat session when switching to a completely different topic. This prevents context confusion and ensures cleaner responses."
+        },
+        {
+          "title": "Handling Errors", 
+          "content": "If you encounter errors or unexpected behavior, restart your chat session using the \"New Chat\" button. This clears the conversation history and resets the context."
+        },
+        {
+          "title": "Keyboard Shortcuts",
+          "content": "Learn these helpful shortcuts to improve your workflow.",
+          "shortcuts": [
+            {"key": "Ctrl+Alt+N", "description": "Start new chat"},
+            {"key": "Enter", "description": "Send message"},
+            {"key": "Shift+Enter", "description": "New line in message"}
+          ]
+        }
+      ]
+    },
+    {
+      "id": "technical-docs",
+      "type": "section",
+      "title": "Technical Documentation",
+      "icon": "code",
+      "iconColor": "orange-400", 
+      "layout": "technical",
+      "subsections": [
+        {
+          "title": "Building Your Own MCP Server",
+          "borderColor": "orange-400",
+          "description": "Create custom tools and functionality by developing your own MCP servers.",
+          "content": [
+            {
+              "type": "subsection",
+              "title": "Special Return Types",
+              "bullets": [
+                {"code": "returned_files", "description": "Return files for Canvas rendering (HTML, images, PDFs, text)"},
+                {"code": "file_path", "description": "Reference files for download/display"},
+                {"code": "content", "description": "Standard text response"},
+                {"code": "success", "description": "Boolean indicating operation success"}
+              ]
+            },
+            {
+              "type": "code-example",
+              "title": "Returned Files Example",
+              "language": "json",
+              "code": "{\n    \"content\": \"Created interactive chart\",\n    \"returned_files\": [{\n        \"filename\": \"chart.html\",\n        \"content_base64\": \"PGRpdj5Zb3VyIEhUTUwgaGVyZTwvZGl2Pg==\"\n    }],\n    \"success\": true\n}"
+            }
+          ]
+        },
+        {
+          "title": "UI Modification & Custom Prompts",
+          "borderColor": "cyan-400",
+          "description": "Advanced customization options for developers.",
+          "bullets": [
+            "MCP servers can return files (HTML, images, PDFs, text) that render in the Canvas panel",
+            "All HTML is sanitized for security using DOMPurify", 
+            "JavaScript is supported for interactive elements",
+            "Use custom prompts to modify AI behavior",
+            "Create specialized tools for domain-specific tasks"
+          ]
+        },
+        {
+          "title": "Development Resources",
+          "type": "resource-card",
+          "resources": [
+            {"file": "docs/mcp-development.md", "description": "Comprehensive MCP development guide"},
+            {"file": "docs/advanced-features.md", "description": "Advanced features and examples"},
+            {"file": "docs/configuration.md", "description": "Configuration options"},
+            {"file": "backend/mcp/", "description": "Example MCP server implementations"}
+          ]
+        }
+      ]
+    },
+    {
+      "id": "agent-mode",
+      "type": "section",
+      "title": "Agent Mode",
+      "icon": "bot", 
+      "iconColor": "gradient",
+      "gradientFrom": "blue-400",
+      "gradientTo": "purple-600",
+      "layout": "simple",
+      "description": "Agent mode enables multi-step reasoning where the AI breaks down complex tasks into manageable steps.",
+      "features": [
+        "Step-by-step task breakdown and execution",
+        "Visual progress tracking", 
+        "Integration with MCP tools during reasoning",
+        "Ability to interrupt the reasoning process"
+      ],
+      "note": "Agent mode availability depends on your configuration. Check with your administrator if this feature is not visible."
+    },
+    {
+      "id": "support",
+      "type": "section",
+      "title": "Need More Help?",
+      "icon": "file-text",
+      "iconColor": "gray-400",
+      "layout": "support-cards",
+      "description": "For additional information and detailed guides:",
+      "cards": [
+        {
+          "title": "Documentation",
+          "content": "Check the docs/ folder for comprehensive guides on setup, configuration, and development.",
+          "code": "docs/"
+        },
+        {
+          "title": "Configuration", 
+          "content": "Refer to .env.example and configuration documentation for customization options.",
+          "code": ".env.example"
+        }
+      ]
+    }
+  ]
+}

atlas_chat-0.1.0.data/data/config/defaults/llmconfig-buggy.yml

@@ -0,0 +1,11 @@
+models:
+  mock-llm-rate-limited:
+    model_url: "http://127.0.0.1:8002/v1"
+    model_name: "openai/mock-model"
+    api_key: "dummy-key"  # Not used by mock server
+    description: "Mock LLM server with rate limiting and error simulation for testing"
+    compliance_level: "Internal"
+    # Extra configuration for this mock server
+    max_retries: 3
+    retry_delay: 1.0
+    timeout_seconds: 30

atlas_chat-0.1.0.data/data/config/defaults/llmconfig.yml

@@ -0,0 +1,19 @@
+models:
+  gpt-4.1:
+    model_url: "https://api.openai.com/v1/chat/completions"
+    model_name: "gpt-4.1"
+    api_key: "${OPENAI_API_KEY}"
+    compliance_level: "External"
+  gpt-4.1-nano:
+    model_url: "https://api.openai.com/v1/chat/completions"
+    model_name: "gpt-4.1-nano"
+    api_key: "${OPENAI_API_KEY}"
+    compliance_level: "External"
+  openrouter-gpt-4o:
+    model_url: "https://openrouter.ai/api/v1/chat/completions"
+    model_name: "openai/gpt-oss-120b"
+    api_key: "${OPENROUTER_API_KEY}"
+    description: "OpenRouter openai oss-120b"
+    compliance_level: "External"
+    extra_headers:
+      X-Title: "chat-11"

atlas_chat-0.1.0.data/data/config/defaults/mcp.json

@@ -0,0 +1,138 @@
+{
+  "calculator": {
+    "command": [
+      "python",
+      "mcp/calculator/main.py"
+    ],
+    "cwd": "atlas",
+    "groups": [
+      "users"
+    ],
+    "description": "Evaluate mathematical expressions, perform calculations with basic arithmetic, trigonometry, and logarithms",
+    "author": "Chat UI Team",
+    "short_description": "Mathematical calculator",
+    "help_email": "support@chatui.example.com",
+    "compliance_level": "Public"
+  },
+  "thinking": {
+    "command": [
+      "python",
+      "mcp/thinking/main.py"
+    ],
+    "cwd": "atlas",
+    "groups": [
+      "users"
+    ],
+    "description": "Structured thinking and problem analysis tool",
+    "author": "Chat UI Team",
+    "short_description": "Structured problem analysis",
+    "help_email": "support@chatui.example.com",
+    "compliance_level": "Public"
+  },
+  "pdfbasic": {
+    "command": [
+      "python",
+      "mcp/pdfbasic/main.py"
+    ],
+    "cwd": "atlas",
+    "groups": [
+      "users"
+    ],
+    "description": "Extract and analyze text content from PDF documents, search within PDFs, and summarize content",
+    "author": "Chat UI Team",
+    "short_description": "PDF text extraction and analysis",
+    "help_email": "support@chatui.example.com",
+    "compliance_level": "SOC2"
+  },
+  "ui-demo": {
+    "command": [
+      "python",
+      "mcp/ui-demo/main.py"
+    ],
+    "cwd": "atlas",
+    "groups": [
+      "users"
+    ],
+    "description": "Demo server showcasing custom UI modification capabilities",
+    "author": "Chat UI Team",
+    "short_description": "UI customization demo",
+    "help_email": "support@chatui.example.com",
+    "compliance_level": "Public"
+  },
+  "code-executor": {
+    "command": [
+      "python",
+      "mcp/code-executor/main.py"
+    ],
+    "cwd": "atlas",
+    "groups": [
+      "users"
+    ],
+    "description": "Execute Python, JavaScript, and other code snippets in a secure sandboxed environment with safety validation",
+    "author": "Chat UI Team",
+    "short_description": "Secure code execution sandbox",
+    "help_email": "support@chatui.example.com",
+    "compliance_level": "SOC2"
+  },
+  "prompts": {
+    "command": [
+      "python",
+      "mcp/prompts/main.py"
+    ],
+    "cwd": "atlas",
+    "groups": [
+      "users"
+    ],
+    "description": "Specialized system prompts for AI behavior modification",
+    "author": "Chat UI Team",
+    "short_description": "AI behavior prompts",
+    "help_email": "support@chatui.example.com",
+    "compliance_level": "Public"
+  },
+  "env-demo": {
+    "command": [
+      "python",
+      "mcp/env-demo/main.py"
+    ],
+    "cwd": "atlas",
+    "env": {
+      "CLOUD_PROFILE": "demo-profile",
+      "CLOUD_REGION": "us-west-2",
+      "DEBUG_MODE": "true",
+      "ENVIRONMENT": "development",
+      "API_KEY": "${DEMO_API_KEY}"
+    },
+    "groups": [
+      "users"
+    ],
+    "description": "Demonstrates environment variable passing to MCP servers. Shows how to configure servers with env vars in mcp.json using both literal values and ${VAR} substitution.",
+    "author": "Chat UI Team",
+    "short_description": "Environment variable demonstration",
+    "help_email": "support@chatui.example.com",
+    "compliance_level": "Public"
+  },
+  "external-api-example": {
+    "url": "http://127.0.0.1:8005/mcp",
+    "transport": "http",
+    "groups": [
+      "users"
+    ],
+    "description": "Mock HTTP MCP server for testing authentication",
+    "auth_token": "${MCP_EXTERNAL_API_TOKEN}"
+  }, 
+   "many_tools_demo": {
+    "command": [
+      "python",
+      "mcp/many_tools_demo/main.py"
+    ],
+    "cwd": "atlas",
+    "groups": [
+      "users"
+    ],
+    "description": "Demo server with 64 tools to test UI scalability with large numbers of tools. Includes operations for data, analytics, files, network, system, database, security, and reporting.",
+    "author": "Chat UI Team",
+    "short_description": "Large tool set demo (64 tools)",
+    "help_email": "support@chatui.example.com",
+    "compliance_level": "Public"
+  }
+}

atlas_chat-0.1.0.data/data/config/defaults/rag-sources.json

@@ -0,0 +1,17 @@
+{
+  "corporate_cars": {
+    "type": "mcp",
+    "display_name": "Corporate Cars",
+    "description": "Fleet RAG server: discover resources and retrieve locations/meta-data for corporate cars in use by employees.",
+    "icon": "car",
+    "command": [
+      "python",
+      "mcp/corporate_cars/main.py"
+    ],
+    "cwd": "atlas",
+    "groups": [
+      "users"
+    ],
+    "compliance_level": "SOC2"
+  }
+}

atlas_chat-0.1.0.data/data/config/defaults/splash-config.json

@@ -0,0 +1,16 @@
+{
+  "enabled": false,
+  "title": "Welcome to Chat UI",
+  "messages": [
+    {
+      "type": "text",
+      "content": "Welcome! Please review our policies before continuing."
+    }
+  ],
+  "dismissible": true,
+  "require_accept": false,
+  "dismiss_duration_days": 30,
+  "accept_button_text": "Accept",
+  "dismiss_button_text": "Dismiss",
+  "show_on_every_visit": false
+}

atlas_chat-0.1.0.dist-info/METADATA

@@ -0,0 +1,236 @@
+Metadata-Version: 2.4
+Name: atlas-chat
+Version: 0.1.0
+Summary: Full-stack LLM chat interface with Model Context Protocol (MCP) integration
+Author: Sandia National Laboratories
+License: MIT
+Project-URL: Homepage, https://github.com/sandialabs/atlas
+Project-URL: Documentation, https://github.com/sandialabs/atlas/tree/main/docs
+Project-URL: Repository, https://github.com/sandialabs/atlas
+Project-URL: Issues, https://github.com/sandialabs/atlas/issues
+Keywords: llm,chat,mcp,ai,anthropic,openai,gemini
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: beautifulsoup4
+Requires-Dist: boto3>=1.34.0
+Requires-Dist: bs4
+Requires-Dist: cryptography
+Requires-Dist: duckduckgo-search
+Requires-Dist: fastapi
+Requires-Dist: fastmcp>=2.10.0
+Requires-Dist: httpx
+Requires-Dist: litellm
+Requires-Dist: matplotlib
+Requires-Dist: numpy
+Requires-Dist: openpyxl
+Requires-Dist: opentelemetry-api
+Requires-Dist: opentelemetry-exporter-otlp
+Requires-Dist: opentelemetry-instrumentation-fastapi
+Requires-Dist: opentelemetry-instrumentation-httpx
+Requires-Dist: opentelemetry-instrumentation-logging
+Requires-Dist: opentelemetry-sdk
+Requires-Dist: pandas
+Requires-Dist: pydantic
+Requires-Dist: PyJWT
+Requires-Dist: PyPDF2
+Requires-Dist: python-dotenv
+Requires-Dist: python-multipart
+Requires-Dist: python-pptx
+Requires-Dist: pyyaml
+Requires-Dist: reportlab
+Requires-Dist: requests
+Requires-Dist: scikit-learn
+Requires-Dist: scipy
+Requires-Dist: seaborn
+Requires-Dist: uvicorn[standard]
+Requires-Dist: websockets
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: pytest-mock; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+
+# Atlas UI 3
+
+[![CI/CD Pipeline](https://github.com/sandialabs/atlas-ui-3/actions/workflows/ci.yml/badge.svg)](https://github.com/sandialabs/atlas-ui-3/actions/workflows/ci.yml)
+[![Security Checks](https://github.com/sandialabs/atlas-ui-3/actions/workflows/security.yml/badge.svg)](https://github.com/sandialabs/atlas-ui-3/actions/workflows/security.yml)
+[![Docker Image](https://ghcr-badge.egpl.dev/sandialabs/atlas-ui-3/latest_tag?trim=major&label=latest)](https://github.com/sandialabs/atlas-ui-3/pkgs/container/atlas-ui-3)
+[![PyPI version](https://badge.fury.io/py/atlas-chat.svg)](https://badge.fury.io/py/atlas-chat)
+![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)
+![React 19](https://img.shields.io/badge/react-19.2-blue.svg)
+![License MIT](https://img.shields.io/badge/license-MIT-blue.svg)
+
+Atlas UI 3 is a secure chat application with MCP (Model Context Protocol) integration, developed by Sandia National Laboratories -- a U.S. Department of Energy national laboratory -- to support U.S. Government customers.
+
+
+
+![Screenshot](docs/readme_img/screenshot-11-6-2025image.png)
+
+## About the Project
+
+**Atlas UI 3** is a full-stack LLM chat interface that supports multiple AI models, including those from OpenAI, Anthropic, and Google. Its core feature is the integration with the Model Context Protocol (MCP), which allows the AI assistant to connect to external tools and data sources, enabling complex, real-time workflows.
+
+### Features
+
+*   **Multi-LLM Support**: Connect to various LLM providers.
+*   **MCP Integration**: Extend the AI's capabilities with custom tools.
+*   **RAG Support**: Enhance responses with Retrieval-Augmented Generation.
+*   **Secure and Configurable**: Features group-based access control, compliance levels, and a tool approval system.
+*   **Modern Stack**: Built with React 19, FastAPI, and WebSockets.
+*   **Python Package**: Install and use as a library or CLI tool.
+
+## Installation
+
+### Install from PyPI (Recommended for Users)
+
+```bash
+# Install the package
+pip install atlas-chat
+
+# Or with uv (faster)
+uv pip install atlas-chat
+```
+
+### CLI Usage
+
+After installation, three CLI tools are available:
+
+```bash
+# Set up configuration (run this first!)
+atlas-init              # Creates .env and config/ in current directory
+atlas-init --minimal    # Creates just a minimal .env file
+
+# Chat with an LLM
+atlas-chat "Hello, how are you?" --model gpt-4o
+atlas-chat "Use the search tool" --tools server_tool1
+atlas-chat --list-tools
+
+# Start the server
+atlas-server --port 8000
+atlas-server --env /path/to/.env --config-folder /path/to/config
+```
+
+### Python API Usage
+
+```python
+from atlas import AtlasClient, ChatResult
+
+# Async usage
+client = AtlasClient()
+result = await client.chat("Hello, how are you?")
+print(result.message)
+
+# With options
+result = await client.chat(
+    "Analyze this data",
+    model="gpt-4o",
+    selected_tools=["calculator", "search"],
+    agent_mode=True
+)
+
+# Sync wrapper
+result = client.chat_sync("Hello!")
+```
+
+## Quick Start (Development)
+
+### Prerequisites
+
+```bash
+# Install uv package manager (one-time)
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Create virtual environment and install dependencies
+uv venv && source .venv/bin/activate
+uv pip install -r requirements.txt
+```
+
+### Development Installation (Editable Mode)
+
+For development, install the package in **editable mode**. This creates a link from your Python environment to your local source code, so any changes you make to the code are immediately available without reinstalling.
+
+```bash
+# Install in editable mode with uv (recommended)
+uv pip install -e .
+
+# Or with pip
+pip install -e .
+```
+
+**What editable mode gives you:**
+- Edit any Python file in `atlas/` and changes take effect immediately
+- CLI commands (`atlas-chat`, `atlas-server`) use your local code
+- Import `from atlas import AtlasClient` in scripts and get your local version
+- No need to reinstall after making changes
+
+**Example workflow:**
+```bash
+# Install once in editable mode
+uv pip install -e .
+
+# Edit code
+vim atlas/atlas_client.py
+
+# Run immediately with your changes - no reinstall needed
+atlas-chat "test my changes"
+python my_script.py  # uses updated AtlasClient
+```
+
+**Alternative: PYTHONPATH (if you can't use editable install)**
+```bash
+# Set PYTHONPATH manually when running
+PYTHONPATH=/path/to/atlas-ui-3 python atlas/main.py
+```
+
+### Running the Application
+
+**Linux/macOS:**
+```bash
+bash agent_start.sh
+```
+
+**Windows:**
+```powershell
+.\ps_agent_start.ps1
+```
+
+**Note for Windows users**: If you encounter frontend build errors related to Rollup dependencies, delete `frontend/package-lock.json` and `frontend/node_modules`, then run the script again.
+
+Both scripts automatically detect and work with Docker or Podman. The `agent_start.sh` script builds the frontend, starts necessary services, and launches the backend server.
+
+## Documentation
+
+We have created a set of comprehensive guides to help you get the most out of Atlas UI 3.
+
+*   **[Getting Started](./docs/getting-started/installation.md)**: The perfect starting point for all users. This guide covers how to get the application running with Docker or on your local machine.
+
+*   **[Administrator's Guide](./docs/admin/README.md)**: For those who will deploy and manage the application. This guide details configuration, security settings, access control, and other operational topics.
+
+*   **[Developer's Guide](./docs/developer/README.md)**: For developers who want to contribute to the project. It provides an overview of the architecture and instructions for creating new MCP servers.
+
+## Container Images
+
+Pre-built container images are available at `quay.io/agarlan-snl/atlas-ui-3:latest` (pushes automatically from main branch).
+
+## For AI Agent Contributors
+
+If you are an AI agent working on this repository, please refer to the following documents for the most current and concise guidance:
+
+*   **[CLAUDE.md](./CLAUDE.md)**: Detailed architecture, workflows, and conventions.
+*   **[GEMINI.md](./GEMINI.md)**: Gemini-specific instructions.
+*   **[.github/copilot-instructions.md](./.github/copilot-instructions.md)**: A compact guide for getting productive quickly.
+
+## License
+
+Copyright 2025 National Technology & Engineering Solutions of Sandia, LLC (NTESS). Under the terms of Contract DE-NA0003525 with NTESS, the U.S. Government retains certain rights in this software
+
+MIT License
+