handle merge conflicts

Author: normand1

.env.example

@@ -3,6 +3,7 @@ DISCORD_APPLICATION_ID=
 DISCORD_API_TOKEN= # Bot token
 OPENAI_API_KEY=sk-* # OpenAI API key, starting with sk-
 REDPILL_API_KEY= # REDPILL API Key
+GROK_API_KEY= # GROK API Key
 GROQ_API_KEY=gsk_*
 OPENROUTER_API_KEY=
 GOOGLE_GENERATIVE_AI_API_KEY= # Gemini API key
@@ -37,20 +38,20 @@ POST_INTERVAL_MAX= #180 #Default
 #USE IMAGE GEN
 IMAGE_GEN= #TRUE
 
-#Leave blank to use local embeddings 
+#Leave blank to use local embeddings
 USE_OPENAI_EMBEDDING=  #TRUE
 
 #OpenRouter (Use one model for everything or set individual for small, medium, large tasks)
 #leave blank to use defaults hermes 70b for small tasks & 405b for medium/large tasks
 OPENROUTER_MODEL=
-SMALL_OPENROUTER_MODEL= 
-MEDIUM_OLLAMA_MODEL= 
-LARGE_OLLAMA_MODEL= 
+SMALL_OPENROUTER_MODEL=
+MEDIUM_OLLAMA_MODEL=
+LARGE_OLLAMA_MODEL=
 
 
-#Set to Use for New OLLAMA provider 
+#Set to Use for New OLLAMA provider
 OLLAMA_SERVER_URL=   #Leave blank for default localhost:11434
-OLLAMA_MODEL= 
+OLLAMA_MODEL=
 OLLAMA_EMBEDDING_MODEL=     #default mxbai-embed-large
 #To use custom model types for different tasks set these
 SMALL_OLLAMA_MODEL=         #default llama3.2

README.md

@@ -11,7 +11,8 @@
 </div>
 
 ## 🌍 README Translations
-[中文说明](./README_CN.md) | [日本語の説明](./README_JA.md) | [한국어 설명](./README_KOR.md) | [Français](./README_FR.md) | [Português](./README_PTBR.md) | [Türkçe](./README_TR.md) | [Русский](./README_RU.md) | [Español](./README_ES.md)
+
+[中文说明](./README_CN.md) | [日本語の説明](./README_JA.md) | [한국어 설명](./README_KOR.md) | [Français](./README_FR.md) | [Português](./README_PTBR.md) | [Türkçe](./README_TR.md) | [Русский](./README_RU.md) | [Español](./README_ES.md) | [Italiano](./README_IT.md)
 
 ## ✨ Features
 
@@ -40,7 +41,7 @@
 -   [Node.js 22+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
 -   [pnpm](https://pnpm.io/installation)
 
-> **Note for Windows Users:** WSL is required
+> **Note for Windows Users:** [WSL 2](https://learn.microsoft.com/en-us/windows/wsl/install-manual) is required.
 
 ### Edit the .env file
 

README_IT.md

@@ -0,0 +1,92 @@
+# Eliza 🤖
+
+<div align="center">
+  <img src="./docs/static/img/eliza_banner.jpg" alt="Eliza Banner" width="100%" />
+</div>
+
+## ✨ Caratteristiche
+
+-   🛠️ Connettori completi per Discord, Twitter e Telegram
+-   🔗 Supporto per tutti i modelli (Llama, Grok, OpenAI, Anthropic, ecc.)
+-   👥 Supporto multi-agente e per stanze
+-   📚 Acquisisci ed interagisci facilmente con i tuoi documenti
+-   💾 Memoria recuperabile e archivio documenti
+-   🚀 Altamente estensibile - crea le tue azioni e clients personalizzati
+-   ☁️ Supporto di numerosi modelli (Llama locale, OpenAI, Anthropic, Groq, ecc.)
+-   📦 Funziona e basta!
+
+## 🎯 Casi d'Uso
+
+-   🤖 Chatbot
+-   🕵️ Agenti Autonomi
+-   📈 Gestione Processi Aziendali
+-   🎮 NPC per Videogiochi
+-   🧠 Trading
+
+## 🚀 Avvio Rapido
+
+### Prerequisiti
+
+-   [Python 2.7+](https://www.python.org/downloads/)
+-   [Node.js 22+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
+-   [pnpm](https://pnpm.io/installation)
+
+> **Nota per gli utenti Windows:** È richiesto WSL
+
+### Modifica il file .env
+
+Copia .env.example in .env e inserisci i valori appropriati
+
+```
+cp .env.example .env
+```
+
+### Avvia Eliza Automaticamente
+
+Questo script eseguirà tutti i comandi necessari per configurare il progetto e avviare il bot con il personaggio predefinito.
+
+```bash
+sh scripts/start.sh
+```
+
+### Modifica il file del personaggio
+
+1. Apri `packages/agent/src/character.ts` per modificare il personaggio predefinito. Decommentare e modificare.
+
+2. Per caricare personaggi personalizzati:
+    - Usa `pnpm start --characters="percorso/del/tuo/personaggio.json"`
+    - È possibile caricare più file di personaggi contemporaneamente
+
+### Avvia Eliza Manualmente
+
+```bash
+pnpm i
+pnpm build
+pnpm start
+
+# Il progetto evolve rapidamente; a volte è necessario pulire il progetto se si ritorna sul progetto dopo un po' di tempo
+pnpm clean
+```
+
+#### Requisiti Aggiuntivi
+
+Potrebbe essere necessario installare Sharp. Se vedi un errore all'avvio, prova a installarlo con il seguente comando:
+
+```
+pnpm install --include=optional sharp
+```
+
+### Community e contatti
+
+-   [GitHub Issues](https://github.com/ai16z/eliza/issues). Ideale per: bug riscontrati utilizzando Eliza e proposte di funzionalità.
+-   [Discord](https://discord.gg/ai16z). Ideale per: condividere le tue applicazioni e interagire con la community.
+
+## Contributori
+
+<a href="https://github.com/ai16z/eliza/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=ai16z/eliza" />
+</a>
+
+## Cronologia Stelle
+
+[![Grafico Cronologia Stelle](https://api.star-history.com/svg?repos=ai16z/eliza&type=Date)](https://star-history.com/#ai16z/eliza&Date) 

docs/docs/core/actions.md

@@ -6,6 +6,8 @@ sidebar_position: 6
 
 Actions are core building blocks in Eliza that define how agents respond to and interact with messages. They allow agents to interact with external systems, modify their behavior, and perform tasks beyond simple message responses.
 
+---
+
 ## Overview
 
 Each Action consists of:
@@ -17,6 +19,8 @@ Each Action consists of:
 - `handler`: Implementation of the action's behavior
 - `examples`: Array of example usage patterns
 
+---
+
 ## Implementation
 
 ```typescript
@@ -36,6 +40,8 @@ Source: https://github.com/ai16z/eliza/packages/core/src/types.ts
 
 # Built-in Actions
 
+---
+
 ## Conversation Flow
 
 ### CONTINUE
@@ -57,6 +63,8 @@ Source: https://github.com/ai16z/eliza/packages/core/src/types.ts
 - Default response action
 - Used for standard conversational replies
 
+---
+
 ## External Integrations
 
 ### TAKE_ORDER
@@ -81,6 +89,8 @@ const take_order: Action = {
 
 Source: https://github.com/ai16z/eliza/packages/plugin-solana/src/actions/takeOrder.ts
 
+---
+
 ## Creating Custom Actions
 
 1. Implement the Action interface
@@ -123,6 +133,8 @@ test("Validate action behavior", async () => {
 });
 ```
 
+---
+
 ## Core Concepts
 
 ### Action Structure
@@ -151,6 +163,8 @@ interface Action {
 - **handler**: Implements the action's behavior
 - **examples**: Demonstrates proper usage patterns
 
+---
+
 ## Built-in Actions
 
 ### CONTINUE
@@ -205,6 +219,8 @@ const followRoomAction: Action = {
 };
 ```
 
+---
+
 ## Creating Custom Actions
 
 ### Basic Action Template
@@ -273,6 +289,8 @@ const complexAction: Action = {
 };
 ```
 
+---
+
 ## Implementation Patterns
 
 ### State-Based Actions
@@ -310,6 +328,8 @@ const serviceAction: Action = {
 };
 ```
 
+---
+
 ## Best Practices
 
 ### Action Design
@@ -368,6 +388,8 @@ examples: [
 ];
 ```
 
+---
+
 ## Troubleshooting
 
 ### Common Issues
@@ -425,6 +447,8 @@ const chainedAction: Action = {
 };
 ```
 
+---
+
 ## Example: Complete Action Implementation
 
 ```typescript
@@ -498,6 +522,8 @@ const documentAnalysisAction: Action = {
 };
 ```
 
+---
+
 # Best Practices
 
 1. **Validation**
@@ -517,6 +543,8 @@ const documentAnalysisAction: Action = {
    - Document expected inputs/outputs
    - Explain error scenarios
 
+---
+
 ## Further Reading
 
 - [Provider System](./providers.md)

docs/docs/core/agents.md

@@ -10,7 +10,7 @@ Agents are the core components of the Eliza framework that handle autonomous int
 
 ## Overview
 
-The [AgentRuntime](/api/classes/AgentRuntime) class is the primary implementation of the [IAgentRuntime](/api/interfaces) interface, which manages the agent's core functions, including:
+The [AgentRuntime](/api/classes/AgentRuntime) class is the primary implementation of the [IAgentRuntime](/api/interfaces/IAgentRuntime) interface, which manages the agent's core functions, including:
 
 - **Message and Memory Processing**: Storing, retrieving, and managing conversation data and contextual memory.
 - **State Management**: Composing and updating the agent’s state for a coherent, ongoing interaction.
@@ -90,7 +90,7 @@ const runtime = new AgentRuntime({
 
 ## State Management
 
-This section should cover how agents manage and update state, with a focus on initial state composition and updating methods. The runtime maintains state through the [State](/api/interfaces) interface:
+This section should cover how agents manage and update state, with a focus on initial state composition and updating methods. The runtime maintains state through the [State](/api/interfaces/state) interface:
 
 ```typescript
 interface State {
@@ -148,7 +148,7 @@ The Eliza framework uses multiple types of memory to support an agent's long-ter
 
 - **RAG Integration**: Uses a vector search to perform contextual recall based on similarity matching. This enables the agent to retrieve relevant memory snippets or knowledge based on the content and intent of the current conversation, making its responses more contextually relevant.
 
-The runtime uses multiple specialized [IMemoryManager](/api/interfaces) instances:
+The runtime uses multiple specialized [IMemoryManager](/api/interfaces/IMemoryManager) instances:
 
 - `messageManager` - conversation messages and responses
 - `descriptionManager` - user descriptions and profiles
@@ -210,6 +210,8 @@ await memoryManager.createMemory({
 - Use immutability in state management.
 - Log errors and maintain stability during service failures.
 
+---
+
 ## Evaluation System
 
 The runtime's [evaluate](/api/classes/AgentRuntime#evaluate) method processes evaluations:
@@ -250,6 +252,7 @@ await memoryManager.createMemory({
   roomId,
 });
 ```
+---
 
 ## Further Reading
 

docs/docs/core/characterfile.md

@@ -6,9 +6,11 @@ sidebar_position: 4
 
 Character files are JSON-formatted configurations that define an AI character's personality, knowledge, and behavior patterns. This guide explains how to create effective character files for use with Eliza agents.
 
+---
+
 ## Overview
 
-A `characterfile` implements the [Character](/api/type-aliases) type and defines the character's:
+A `characterfile` implements the [Character](/api/type-aliases/character) type and defines the character's:
 
 - Core identity and behavior
 - Model provider configuration
@@ -90,11 +92,11 @@ The character's display name for identification and in conversations.
 
 #### `modelProvider` (required)
 
-Specifies the AI model provider. Supported options from [ModelProviderName](/api/enumerations) include `ANTHROPIC`, `LLAMALOCAL`, `OPENAI`, and others.
+Specifies the AI model provider. Supported options from [ModelProviderName](/api/enumerations/modelprovidername) include `ANTHROPIC`, `LLAMALOCAL`, `OPENAI`, and others.
 
 #### `clients` (required)
 
-Array of supported client types from [Clients](/api/enumerations) e.g., `DISCORD`, `DIRECT`, `TWITTER`, `TELEGRAM`.
+Array of supported client types from [Clients](/api/enumerations/clients) e.g., `DISCORD`, `DIRECT`, `TWITTER`, `TELEGRAM`.
 
 #### `bio`
 
@@ -205,6 +207,8 @@ The `settings` object defines additional configurations like secrets and voice m
 }
 ```
 
+---
+
 ## Example: Complete Character File
 
 ```json
@@ -290,6 +294,8 @@ npx knowledge2character <character-file> <knowledge-file>
 - Show character-specific responses
 - Demonstrate typical interaction patterns
 
+---
+
 ## Tips for Quality
 
 1. **Bio and Lore**
@@ -316,6 +322,8 @@ npx knowledge2character <character-file> <knowledge-file>
 - Organize in digestible chunks
 - Update regularly to maintain relevance
 
+---
+
 ## Further Reading
 
 - [Agents Documentation](./agents.md)