Update README.md
Better README.md description.
This commit is contained in:
parent
b8aad57b09
commit
fc79563f79
93
README.md
93
README.md
@ -1 +1,92 @@
|
||||
AI console agent
|
||||
# ConsoleX 2.4.13 - Lokaal console-agent voor je LLM Proxy
|
||||
|
||||
ConsoleX is een lokale agent die interactie mogelijk maakt met een LLM (Large Language Model) proxy via verschillende tools zoals bestandbeheer, shell-uitvoering en webzoeken.
|
||||
|
||||
## Features ✨
|
||||
- **Bestandsmanipulatie**: Lees, schrijf, bijwerk en zoek in tekstbestanden.
|
||||
- **Shell-ondersteuning**: Voer command-line commando's uit met opties als tijdsbeperking (timeout) en werkdirectory (cwd).
|
||||
- **Webzoek tools**: Zoeken op het web via Google, SerpAPI of DuckDuckGo backends.
|
||||
- **Background modus**: Stel vragen aan de gebruiker in background-modus voor geautomatiseerde workflows.
|
||||
- **RAG ondersteuning**: Beheer en zoek naar lokale RAG (Retrieval Augmented Generation) documenten.
|
||||
- **Task management**: Werk met doelen, taken en statusupdates.
|
||||
|
||||
## Installatie & Configuratie 🛠️
|
||||
|
||||
1. **Voorkeure configureren** via milieueigen variabelen:
|
||||
- `CONSOLEX_BASE_URL`: URL van je LLM proxy (default: `http://localhost:8080/v1`)
|
||||
- `MODEL` : Naam van het model dat gebruikt wordt door de proxy.
|
||||
- `TIMEOUT_S`: Tijdsbeperking voor tool-uitvoering in seconden.
|
||||
|
||||
2. **Installatie** via pip (als nodig):
|
||||
```bash
|
||||
pip install httpx beautifulsoup4 rich
|
||||
```
|
||||
|
||||
## Gebruik 📌
|
||||
|
||||
### Starter de agent op:
|
||||
```bash
|
||||
python3 ConsoleX_2_4_13.py
|
||||
```
|
||||
|
||||
### Commanden in het REPL interface:
|
||||
|
||||
- **Background jobs toevoegen**:
|
||||
```bash
|
||||
:add "Voer een command uit"
|
||||
```
|
||||
|
||||
- **Status weergeven van taken en doelen** :
|
||||
```
|
||||
:status
|
||||
:tasks
|
||||
```
|
||||
|
||||
- **Webzoek verrichten** :
|
||||
```bash
|
||||
:tool web_search - query="Python best practices" max_results=3
|
||||
```
|
||||
|
||||
### Voorbeelden:
|
||||
1. Een tekstbestand lezen:
|
||||
```python
|
||||
t_read_file({"path": "example.txt"})
|
||||
```
|
||||
2. Shell commando uitvoeren (met werkdirectory):
|
||||
```python
|
||||
t_run_shell({
|
||||
"command": "ls -l",
|
||||
"cwd": "/home/user/projects"
|
||||
})
|
||||
```
|
||||
|
||||
## Configuratie Opties 📋
|
||||
|
||||
- **Verbale informatie** :
|
||||
```bash
|
||||
:v [0-3] (0: stil, 1: normaal, 2: gedetailleerd, 3: debug)
|
||||
```
|
||||
- **Background modus aan/uit**:
|
||||
```bash
|
||||
:bg on|off
|
||||
```
|
||||
|
||||
## Veranderingen ten opzichte van versie 2.4.12 🔄
|
||||
|
||||
- `ask_user` werkt nu ook in background (BG) modus:
|
||||
- Tijdens een BG-job wordt de vraag met een ID getoond: `[ask_user] job <jobid> vraag <qid>: <question>`
|
||||
Antwoordtje via `:answer <qid> <tekst>`.
|
||||
- Foreground-modus werkt nog steeds als gewoon input.
|
||||
|
||||
## Documentatie & Support 📚
|
||||
|
||||
Voor meer informatie over de API en beschikbare tools, raadpleeg het script `ConsoleX_2_4_13.py` voor details in de functies zoals:
|
||||
```python
|
||||
tool_schema() # Lijst van alle beschikbare tools.
|
||||
t_read_file(), t_write_file(), etc. # Bestandsbeheer functies.
|
||||
```
|
||||
|
||||
## Licentie 📜
|
||||
|
||||
Open source, vrij om te gebruiken en aan te passen onder MIT licentie.
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user