🌌 NEXUS AI Agent

NEXUS is a powerful, autonomous desktop AI agent designed to bridge the gap between Large Language Models and your local file system. Built with LangChain, LangGraph, and NVIDIA AI Endpoints, NEXUS provides a sleek desktop interface to execute complex file management tasks through natural language.

---

🚀 Key Features

• 📂 Autonomous File Management: Read, write, and list files within a secure workspace (ai_workspace).
• 🧠 NVIDIA AI Backend: Leveraging state-of-the-art models like Llama-3.1-8b and Gemma-2-2b for high-performance reasoning.
• 🖥️ Modern Desktop UI: A clean, dark-themed interface built with PySide6 (Qt) for a premium user experience.
• 🛠️ LangGraph Workflow: Advanced agentic logic powered by LangGraph, allowing for reliable tool usage and state management.
• 👁️ LangSmith Integration: Built-in support for LangSmith to trace and optimize agentic performance.

---

🛠️ Tech Stack

• Core Logic: LangChain / LangGraph
• LLM Provider: NVIDIA AI Foundation Endpoints
• UI Framework: PySide6
• Observability: LangSmith
• Environment: Python 3.12+

---

⚙️ Installation

1. Clone the Repository:

   git clone https://github.com/mr-engineer49/ai-agent-langsmith-app.git
   cd ai-agent-langsmith-app

2. Setup Project: This project uses uv for lightning-fast dependency management.

   uv sync
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Configure Environment Variables: Create a .env file in the root directory:

   NVIDIA_API_KEY=your_nvidia_api_key_here
   LANGCHAIN_TRACING_V2=true
   LANGCHAIN_API_KEY=your_langsmith_api_key_here
   LANGCHAIN_PROJECT=NEXUS-Agent

---

🚀 Usage

To launch the NEXUS Desktop Application:

python src/desktop_app/core.py

Example Commands:

• "Create a folder named 'blog_portal' and initialize an index.html inside it."
• "List all files in the workspace."
• "Read the content of success.txt and summarize it."

---

📁 Project Structure

├── ai_workspace/          # Secure area for agent file operations
├── src/
│   └── desktop_app/
│       ├── core.py        # PySide6 Main Application & UI
│       └── llm_backend/
│           └── llm_toolkit.py # LangGraph logic & tool definitions
├── .env                   # Configuration secrets
└── README.md              # You are here

---

🛡️ Safety & Guardrails

NEXUS is restricted to operate exclusively within the ai_workspace directory. This ensures the agent cannot access or modify sensitive system files outside of its designated environment.

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request or open an issue for any bugs or feature requests.

---

📄 License

This project is licensed under the MIT License.