This software provides the ability to link OpenWrt and AI. Based on user input, the AI provides the optimal settings for OpenWrt; the OpenWrt device itself analyzes the information provided by the AI, verifies the validity of that information, and then notifies the user.

Dependency: oasis, lua-curl-v3, luci-compat

The Oasis package can be found under "oasis-1.5.0" in the Releases section of this GitHub page. It is a device-independent package, but it requires dependency packages such as lua-curl-v3 and luci-compat. Typically, if you install Oasis on an OpenWrt device with an active internet connection, these dependency packages will be downloaded and installed automatically.

If the repository corresponding to the device being used as an OpenWrt device does not include lua-curl-v3 or luci-compat, users will need to build the dependency packages themselves using the OpenWrt Buildroot and install them on the OpenWrt device.

root@OpenWrt:~# opkg update
root@OpenWrt:~# opkg install oasis_1.5.0-r1_all.ipk
root@OpenWrt:~# opkg install luci-app-oasis_1.5.0-r1_all.ipk
root@OpenWrt:~# service rpcd reload

Rebooting the system after installation is also fine.

[Main] ---> [Network] ---> [Oasis] ---> [General Setting]

OLLAMA_HOST=0.0.0.0
OLLAMA_ORIGINS=*

[Main] ---> [Network] ---> [Oasis] ---> [Chat with AI]
When chatting with AI for the first time, you can choose what topics to talk about. These options can be freely added or removed by the user in the System Message tab.

When a chat with AI begins, it is given a title and displayed in the chat list on the left side. "Users can continue chatting with AI, and if there is chat data from the past, they can select it to resume the conversation.
Chat data can be renamed, exported, or deleted.

Oasis is customizing the AI to specialize in OpenWrt. Therefore, it may prompt users to ask about OpenWrt. If a user requests configuration related to OpenWrt, the AI will suggest changes using UCI commands.

When a configuration change is suggested by the AI using UCI commands, the internal system of OpenWrt recognizes that a configuration change has been proposed by the AI. It then notifies the user via a popup to apply the configuration change to the current runtime. The user can accept the configuration change by pressing the Apply button.

After applying the settings, if the user can access the WebUI, they will be notified in the Oasis chat screen to finalize the configuration change suggested by the AI. The user can press the Finalize button to approve the configuration change, or press the Rollback button to reject it.

In Oasis, users can create and save system messages to use when starting a chat with AI. System messages are preloaded data used by AI to respond to the user. For example, add a message like the following as a system message to instruct the AI to interpret English and Japanese.
Enter the instructions for the AI into the text area of 'Create System Message' and press the Add button to add it to the System Message List. This will register a new System Message called 'Translator.'
When you return to the Chat with AI tab and start a new chat with the AI, 'Translator' will appear as a topic option.
When 'Translator' is selected, the user's English message will be translated into Japanese by the AI.
In this way, by including instructions or specific knowledge for the AI as system messages, it is possible to modify the AI's behavior toward users. Currently, Oasis adjusts responses related to OpenWrt solely through system messages. As a result, by storing information about OpenWrt settings as knowledge in existing or new system messages, it will become specialized in modifying OpenWrt settings. In particular, Oasis analyzes whether content related to modifying OpenWrt settings (UCI command sequences) found within AI responses can be executed. Then, it notifies the user with a popup.

In Oasis, users can freely change the AI's chat icon to create a sense of familiarity with the AI. Click your preferred icon image and press the Select button to apply the setting. To add your favorite icon image (e.g., png), drag and drop it or click under Upload Icon.
Pressing the Upload button stores the icon in the OpenWrt device.

Dependency: lua-curl-v3

root@OpenWrt:~# opkg update
root@OpenWrt:~# opkg install oasis_1.5.0-r1_all.ipk
root@OpenWrt:~# service rpcd reload

root@OpenWrt:~# oasis
Usage: oasis <command> [[<options>] arguments]...

Options:
 -n <service>           Set the service name
 -u <url>               Set the url or ipaddr for ai service
 -k <api-key>           Set the api-key for ai service
 -m <model>             Set the llm model for ai service

Commands:
 - storage <path> [<chat-max>] (default: chat-max = 30)
 - add [<service> [<url> [<api-key> [<model> [<storage>]]]]]
 - change <service> [<options> <argument>]...
 - select [<service>]
 - delete <service>
 - chat [id=<chat-id>]
 - prompt <message>
 - delchat id=<chat-id>
 - sysrole [[<chat|prompt|call> [<options>] [<system message>]]
 - rename id=<chat-id> <title> 
 - list
 - call <script> <messsage>

Docs
        https://utakamo.com

• Example of OpenAI

root@OpenWrt:~# oasis add
Service Name                   >> my-chatgpt
Endpoint(url)                  >> https://api.openai.com/v1/chat/completions
API KEY (leave blank if none)  >> <your_api-key>
LLM MODEL                      >> gpt-3.5-turbo

• Example of local ai service (Ollama)

root@OpenWrt:~# oasis add
Service Name                   >> my-ollama
Endpoint(url)                  >> http://192.168.3.16:11434/api/chat       
API KEY (leave blank if none)  >>
LLM MODEL                      >> gemma2:2b

• The first service registered with the oasis add command is selected.　

• To switch to another AI service, run oasis select . The following is an example of switching the service in use to my-ollama.

root@OpenWrt:~# oasis chat
You :Hello!

gemma2:2b
Hello! 👋  

How can I help you today? 😄
Title:ConversationStart  ID:7772532380

You :history
{"messages":[{"content":"Hello!","role":"user"},{"content":"Hello! 👋 How can I help you today? 😊 \n","role":"assistant"}],"model":"gemma2:2b"}

You :exit

Confirm Chat ID

root@OpenWrt:~# oasis list
-----------------------------------------------------
 No. | title                          | id
-----------------------------------------------------
[ 1]: Hello                            5727149461
[ 2]: ConversationStart                7772532380

Resume conversation with the AI by specifying the chat ID.

root@OpenWrt:~# oasis chat id=7772532380
You :Hello!

gemma2:2b
Hello! 👋 How can I help you today? 😊

You :

root@OpenWrt:~# oasis prompt "Hello!!"
Hello! 👋  What can I do for you today? 😊 

root@OpenWrt:~# 

root@OpenWrt:~# ubus -v list oasis
'oasis' @a0b66d2b
        "load_icon_info":{"path":"String"}
        "select_icon":{"using":"String","path":"String"}
        "update_sysmsg":{"target":"String","path":"String","title":"String","message":"String"}
        "load_sysmsg":{"path":"String"}
        "delete_icon":{"target":"String","path":"String"}
        "confirm":{}
        "config":{}
        "load_sysmsg_info":{"path":"String"}
        "add_sysmsg":{"message":"String","path":"String","title":"String"}
        "delete_sysmsg":{"target":"String","path":"String"}
root@OpenWrt:~# ubus -v list oasis.chat
'oasis.chat' @8a301e6e
        "delete":{"id":"String"}
        "list":{}
        "append":{"content2":"String","id":"String","role2":"String","role1":"String","content1":"String"}
        "load":{"id":"String"}
        "create":{"content3":"String","content2":"String","content1":"String","role2":"String","role1":"String","role3":"String"}
root@OpenWrt:~# ubus -v list oasis.title
'oasis.title' @1687aa3a
        "auto_set":{"id":"String"}
        "manual_set":{"id":"String","title":"String"}

• lua-curl-v3
• luci-compat

This project is licensed under the MIT License.

This project includes the Material Icons font by Google, licensed under the Apache License, Version 2.0.