feat: init

Author: zhangzeyu.35

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,28 @@
+---
+name: "Bug report"
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+> A clear and concise description of what the bug is.
+
+**To Reproduce**
+> Steps to reproduce the bug.
+
+**Screenshots**
+> If possible, please upload screenshots of the code, console, terminal, etc. to help us understand your problem.
+
+**Reproduce repository**
+> Please provide a condensed code repository and upload it to your own github to help us reproduce your problem.
+
+**Environment**
+- Oxygent version:
+- Build tools & version:
+- Other deployments:
+
+**Logs and Reports**
+> If possible, please upload files containing `/cache_dir` or `/cache_dir_dev` for detailed error logs.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: "Feature request"
+about: Suggest a feature for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+> A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+> A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+> A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+> Add any other context or screenshots about the feature request here.

.github/ISSUE_TEMPLATE/suggestion.md

@@ -0,0 +1,17 @@
+---
+name: "Suggestion"
+about: Other suggestions for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe your suggestion or comments here**
+> A clear and concise description of what your suggestion or comment is.
+
+**Describe factors or reasons you've considered**
+> For ugent or essential suggestions please add your consideration here.
+
+**Additional context**
+> Add any other context or screenshots about the feature request here.

.github/ISSUE_TEMPLATE/xug_other.md

@@ -0,0 +1,11 @@
+---
+name: "Other Issues"
+about: Other issues
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+## Issue content
+> Please add your issue here.

.github/pull_request_template.md

@@ -0,0 +1,54 @@
+### Summary
+
+<!-- Describe the changes introduced by this PR -->
+
+### Related Issue(s)
+
+<!-- Describe relevant issues here, such as: -->
+
+- Closes #123
+- Fixes #456
+
+### Changes
+
+<!-- Describe your changes here, such as: -->
+
+- [ ] Feature A added
+
+contents
+
+- [ ] Refactor B
+
+contents
+
+- [ ] Fix for C
+
+contents
+
+
+<!--
+In each section, please describe design decisions made, including:
+ - Choice of algorithms.
+ - Behavioral aspects. 
+ - Class organization and design.
+ - Method organization and design (how the logic is split between methods, parameters and return types)
+ - Naming (class, method, API, configuration, HTTP endpoint, names of emitted metrics)
+-->
+
+### Screenshots (if UI changes)
+
+<!-- Optional: add before/after screenshots -->
+
+### Checklist
+
+- [ ] been self-reviewed.
+    - [ ] Code is formatted
+    - [ ] Tests added/updated
+    - [ ] All CI checks passed
+    - [ ] Documentation updated
+- [ ] added documentation for new or modified features or behaviors.
+- [ ] added new features, such as new agents, new flows, etc. 
+- [ ] added or updated version, __license__, or notice information.
+- [ ] added or updated demo, integration tests, unit tests, or others.
+- [ ] added or updated ui, or had changes in frontend.
+

.github/workflows/ci.yml

@@ -0,0 +1,39 @@
+name: Oxygent CI
+
+on:
+  push:
+    branches: [main, dev]
+  pull_request:
+    branches: [main, dev]
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        python-version: ["3.10"]
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install pytest pytest-asyncio
+        pip install ruff docformatter
+        pip install -r requirements.txt
+
+    - name: Format code with Ruff (auto-fix)
+      run: |
+        ruff format .
+
+    - name: Run Unit Tests
+      run: |
+        pytest oxygent/test/unittest

.gitignore

@@ -205,3 +205,42 @@ cython_debug/
 marimo/_static/
 marimo/_lsp/
 __marimo__/
+
+# Python 缓存文件和编译文件
+__pycache__/
+*.pyc
+
+# Jupyter Notebook 检查点文件
+.ipynb_checkpoints/
+
+# 常见压缩包及二进制文件
+*.zip
+*.bin
+*.pkl
+
+# 常见项目配置目录及文件（如 IDE 配置）
+.idea/
+.vscode/
+.joycoder/
+.joycode/
+*.iml
+*.xml
+pyproject.toml*
+
+# 数据文件与日志文件
+*.jsonl
+*.log
+*.lock
+
+# macOS 系统生成的隐藏文件
+.DS_Store
+
+# 环境变量及敏感信息文件
+.env
+
+# 运行时产生的文件
+cache_dir/
+cache_dir_dev/
+local_file/
+docs/
+deployment/

CHANGELOG.md

@@ -0,0 +1 @@
+# Changelog

CONTRIBUTING.md

@@ -0,0 +1,70 @@
+<!-- Copyright 2025 JD.com
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this project except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License. -->
+
+[English](./CONTRIBUTING.md) | [中文](./CONTRIBUTING_zh.md)
+
+# Contribute to OxyGent
+
+Our project welcomes contributions from developers and organizations from all over the world. Our project is dedicated to creating a multi-agent development platform for all users, so whether you are an expert in your field or a regular user of the project, we welcome you to participate in shaping the future of this project. You can get involved in the project in the following ways:
+
++ Write / translate / fix our documentation
++ Raise questions / Answer questions
++ Provide demos, examples or test cases
++ Give suggestions or other comments
++ Paticipate in [issues](https://github.com/jd-opensource/OxyGent/issues) or [discussions](https://github.com/jd-opensource/OxyGent/discussions)
++ Pull requests
++ Sharing related research / application
++ Any other ways to improve OxyGent
+
+For developers who want to contribute to our code, here is the guidance:
+
+## 1. Choose an issue to contribute
++ Issues with label `PR welcome`, which means:
+    + A reproducible bug
+    + A function in plan
+
+## 2. Install environment for development
++ We strongly suggest you to read our **[Document](http://oxygent.jd.com/docs/)** before developing
++ For setting environment, please check our  **[Readme file](/README.md)**
+
+## 3. Build our project
++ You could run our demo to check whether the requirements are successfully installed:
+```bash
+    python demo.py
+```
+```bash
+    python -m examples.agents.single_demo
+```
+
+## 4. Test
+We provide some tests to check your code before pull request.
++ Before testing, you should install `pytest`:
+```bash
+    pip install pytest pytest-asyncio
+```
++ Format code:
+```bash
+    ruff format .
+    docformatter -r -i --wrap-summaries 88 --wrap-descriptions 88 oxygent/
+```
++ Unit test:
+```bash
+    pytest oxygent/test/unittest
+```
++ Integration test (Optional):
+```bash
+    pytest oxygent/test/integration
+```
+After the PR is submitted, we will format and test the code.
+Our tests are still far from perfect, so you are welcomed to add tests to our project!