AgentOps OSS release

.pre-commit-config.yaml

@@ -4,4 +4,6 @@ repos:
     hooks:
       - id: ruff
         args: [--fix, --exit-non-zero-on-fix]
+        exclude: ^app/
       - id: ruff-format
+        exclude: ^app/

README.md

@@ -109,6 +109,13 @@ agentops.end_session('Success')
 All your sessions can be viewed on the [AgentOps dashboard](https://app.agentops.ai?ref=gh)
 <br/>
 
+## Run the App and API locally
+
+Looking to run the full AgentOps app (Dashboard + API backend) on your machine? Follow the setup guide in `app/README.md`:
+
+- [Run the App and Backend (Dashboard + API)](app/README.md)
+
+
 <details>
   <summary>Agent Debugging</summary>
   <a href="https://app.agentops.ai?ref=gh">

app/.eslintrc.json

@@ -0,0 +1,56 @@
+{
+  "root": true,
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "next/core-web-vitals",
+    "prettier"
+  ],
+  "plugins": [],
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module"
+  },
+  "rules": {
+    "@typescript-eslint/no-unused-vars": [
+      "warn",
+      {
+        "argsIgnorePattern": "^_",
+        "varsIgnorePattern": "^_",
+        "caughtErrorsIgnorePattern": "^_"
+      }
+    ],
+    "@typescript-eslint/no-explicit-any": "warn",
+    "no-unused-vars": "off",
+    "import/no-unused-modules": [
+      "off"
+    ],
+    "no-console": [
+      "warn",
+      {
+        "allow": [
+          "warn",
+          "error"
+        ]
+      }
+    ]
+  },
+  "ignorePatterns": [
+    "node_modules/",
+    ".next/",
+    "dist/",
+    "build/"
+  ],
+  "overrides": [
+    {
+      "files": [
+        "*.js",
+        "*.jsx"
+      ],
+      "rules": {
+        "@typescript-eslint/no-var-requires": "off"
+      }
+    }
+  ]
+}

app/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,91 @@
+name: Bug Report
+description: Report a bug to help us improve AgentOps
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug! Please fill out the form below to help us understand and fix the issue.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is.
+      placeholder: Describe the bug you encountered...
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior
+      placeholder: |
+        1. Go to '...'
+        2. Click on '...'
+        3. Scroll down to '...'
+        4. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: A clear description of what you expected to happen.
+      placeholder: What should have happened instead?
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened instead?
+      placeholder: What actually happened?
+    validations:
+      required: true
+
+  - type: dropdown
+    id: component
+    attributes:
+      label: Component
+      description: Which component is affected?
+      options:
+        - API Server
+        - Dashboard (Frontend)
+        - Docker Setup
+        - Documentation
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Please provide your environment details
+      placeholder: |
+        - OS: (e.g., macOS 14.0, Ubuntu 20.04, Windows 11)
+        - Node.js version: (e.g., 18.17.0)
+        - Python version: (e.g., 3.12.0)
+        - Browser: (e.g., Chrome 119, Safari 17)
+        - AgentOps version: (e.g., commit hash or branch)
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs and Screenshots
+      description: If applicable, add logs or screenshots to help explain the problem.
+      placeholder: Paste any relevant logs or drag & drop screenshots here
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Add any other context about the problem here.
+      placeholder: Any additional information that might be helpful... 

app/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 💬 GitHub Discussions
+    url: https://github.com/AgentOps-AI/AgentOps.Next/discussions
+    about: Ask questions and discuss ideas with the community
+  - name: 📚 Documentation
+    url: https://github.com/AgentOps-AI/AgentOps.Next/blob/main/README.md
+    about: Check our comprehensive setup and usage documentation
+  - name: 🔒 Security Vulnerability
+    url: https://github.com/AgentOps-AI/AgentOps.Next/blob/main/SECURITY.md
+    about: Report security vulnerabilities privately 

app/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,89 @@
+name: Feature Request
+description: Suggest a new feature or improvement for AgentOps
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a new feature! Please fill out the form below to help us understand your request.
+
+  - type: textarea
+    id: summary
+    attributes:
+      label: Feature Summary
+      description: A clear and concise description of the feature you'd like to see.
+      placeholder: What feature would you like to see added?
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: What problem does this feature solve?
+      placeholder: |
+        Is your feature request related to a problem? Please describe.
+        Example: I'm always frustrated when [...]
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: Describe the solution you'd like to see.
+      placeholder: A clear description of what you want to happen.
+    validations:
+      required: true
+
+  - type: dropdown
+    id: component
+    attributes:
+      label: Component
+      description: Which component would this feature affect?
+      options:
+        - API Server
+        - Dashboard (Frontend)
+        - Docker Setup
+        - Documentation
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Describe any alternative solutions or features you've considered.
+      placeholder: What other approaches have you considered?
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      description: How important is this feature to you?
+      options:
+        - Low - Nice to have
+        - Medium - Would be helpful
+        - High - Important for my use case
+        - Critical - Blocking my adoption
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: contribution
+    attributes:
+      label: Contribution
+      description: Are you willing to help implement this feature?
+      options:
+        - label: I'm willing to submit a PR for this feature
+        - label: I can help with testing
+        - label: I can help with documentation
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Add any other context, mockups, or examples about the feature request.
+      placeholder: Any additional information, mockups, or examples that might be helpful... 

app/.github/ISSUE_TEMPLATE/question.yml

@@ -0,0 +1,56 @@
+name: Question / Help
+description: Ask a question or get help with AgentOps
+title: "[Question]: "
+labels: ["question"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Have a question or need help? We're here to assist!
+
+        **Before asking:** Please check if your question has already been answered in:
+        - [Documentation](https://github.com/AgentOps-AI/AgentOps.Next/blob/main/README.md)
+        - [Existing Issues](https://github.com/AgentOps-AI/AgentOps.Next/issues)
+        - [Discussions](https://github.com/AgentOps-AI/AgentOps.Next/discussions)
+
+  - type: textarea
+    id: question
+    attributes:
+      label: Your Question
+      description: What would you like to know?
+      placeholder: Ask your question here...
+    validations:
+      required: true
+
+  - type: dropdown
+    id: category
+    attributes:
+      label: Category
+      description: What category does your question fall into?
+      options:
+        - Setup / Installation
+        - Configuration
+        - Usage / How-to
+        - API / Integration
+        - Performance
+        - Deployment
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Context
+      description: Provide any relevant context about your setup or use case.
+      placeholder: |
+        - What are you trying to achieve?
+        - What have you already tried?
+        - Any relevant environment details?
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Information
+      description: Any additional information that might help us answer your question.
+      placeholder: Code snippets, error messages, screenshots, etc. 

app/.github/pull_request_template.md

@@ -0,0 +1,45 @@
+## Description
+
+Brief description of changes made in this PR.
+
+## Type of Change
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Code refactoring (no functional changes)
+- [ ] Performance improvement
+- [ ] Other (please describe):
+
+## Related Issues
+
+- Fixes #(issue number)
+- Relates to #(issue number)
+
+## Testing
+
+- [ ] Tests pass locally (`just test`)
+- [ ] Added tests for new functionality
+- [ ] Manual testing completed
+- [ ] No new warnings introduced
+
+**Test Instructions:**
+<!-- Provide steps for reviewers to test your changes -->
+
+## Screenshots (if applicable)
+
+<!-- Add screenshots to help explain your changes -->
+
+## Checklist
+
+- [ ] Code follows project style guidelines (`just lint`)
+- [ ] Self-review completed
+- [ ] Code is commented where necessary
+- [ ] Documentation updated (if needed)
+- [ ] Environment variables documented (if added)
+- [ ] Changelog updated (for significant changes)
+
+## Additional Notes
+
+<!-- Any additional information for reviewers -->