Skip to content

Commit

Permalink
Added contribution guidelines
Browse files Browse the repository at this point in the history
  • Loading branch information
antoninoLorenzo committed Jul 20, 2024
1 parent bec0915 commit 6e91df9
Show file tree
Hide file tree
Showing 2 changed files with 38 additions and 33 deletions.
39 changes: 37 additions & 2 deletions CONTRIBUTE.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,11 @@
- [Submitting Changes](#submitting-changes)
- [General Contribution Process](#general-contribution-process)
- [For New Features](#for-new-features)
4. [Testing](#testing)
4. [Install](#install)
5. [Testing](#testing)
- [LLM Integration](#llm-integration)
- [RAG (Retrieval-Augmented Generation)](#rag-retrieval-augmented-generation)
5. [Code Style and Standards](#code-style-and-standards)
6. [Code Style and Standards](#code-style-and-standards)

# Introduction

Expand Down Expand Up @@ -63,6 +64,40 @@ You can contribute in various ways:
```
4. **Create a Pull Request**: Open a pull request against the `main` branch of the original repository.

## Install

1. **Setup**
- Clone Repository `git clone https://github.com/antoninoLorenzo/AI-OPS.git`
- Install Python requirements `pip install -r requirements.txt`
- Install spacy model `python -m spacy download en_core_web_lg`


2. **Ollama**
- Set remote origins environment variable: `OLLAMA_ORIGINS=1.2.3.4,...` *(Optional)*
- Set host environment variable: `OLLAMA_HOST=0.0.0.0:11434` *(Optional)*
- Run ollama: `ollama serve`


3. **Agent API**
- Launch Agent API (*in development*): `fastapi.exe dev ./src/api.py`

- Access from other machines: `fastapi.exe dev --host 0.0.0.0 ./src/api.py`
- Additional Settings in `.env` file:
```
MODEL=model_name
ENDPOINT=ollama_url
```
*Note: the tools that require root would require also the API to be runned as root*

4. **Setup Tools** (*first time only*)
- move the content of `tools_settings` to `<user home>/.aiops/tools`.

5. **CLI Client**
- Run Client
```
python ai-ops-cli.py --api AGENT_API_ADDRESS
```

## Testing

### LLM Integration
Expand Down
32 changes: 1 addition & 31 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,37 +68,7 @@

### Development

1. **Setup**
- Clone Repository `git clone https://github.com/antoninoLorenzo/AI-OPS.git`
- Install Python requirements `pip install -r requirements.txt`
- Install spacy model `python -m spacy download en_core_web_lg`


2. **Ollama**
- Set remote origins environment variable: `OLLAMA_ORIGINS=1.2.3.4,...` *(Optional)*
- Set host environment variable: `OLLAMA_HOST=0.0.0.0:11434` *(Optional)*
- Run ollama: `ollama serve`


3. **Agent API**
- Launch Agent API (*in development*): `fastapi.exe dev ./src/api.py`

- Access from other machines: `fastapi.exe dev --host 0.0.0.0 ./src/api.py`
- Additional Settings in `.env` file:
```
MODEL=model_name
ENDPOINT=ollama_url
```
*Note: the tools that require root would require also the API to be runned as root*

4. **Setup Tools** (*first time only*)
- move the content of `tools_settings` to `<user home>/.aiops/tools`.

5. **CLI Client**
- Run Client
```
python ai-ops-cli.py --api AGENT_API_ADDRESS
```
See [CONTRIBUTE.md](./CONTRIBUTE.md)

## 📝 Usage

Expand Down

0 comments on commit 6e91df9

Please sign in to comment.