Lumo API 🧠

01.04.2026

📢 Important Update

Since Proton is about to release the Official Lumo Api this repository and all Lumo Api repositories will no longer be maintained. You can Follow the Api developement alongside with some apps that are using the official API ->> : HERE

NEW Introducing Lumo Chat

A new Headless version of the Api just arrived : Take a Look

The new feature Projects just arrived on time

New commands

*** Create Project ***

curl -X POST http://localhost:3000/api/create-project \
  -H "Authorization: Bearer YOUR_SECRET_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "projectName": "My Test Project",
    "projectInstructions": "Use a formal tone and be concise"
  }'

*** Upload File or multiple files to the Project ***

curl -X POST http://localhost:3000/api/upload-file \
  -H "Authorization: Bearer YOUR_SECRET_TOKEN_HERE" \
  -F "files=@./test2.txt"

*** Send prompt to sumarize the files ***

curl -X POST http://localhost:3000/api/send-prompt \
  -H "Authorization: Bearer YOUR_SECRET_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "Summarize the last uploaded file." }'

*** To delete files you can use the same previous commands ***

Note: In projects is not possible to send files and prompt together

*** Leave the project and return to normal chat ***

curl -X POST http://localhost:3000/api/start-new-chat \
  -H "Authorization: Bearer YOUR_SECRET_TOKEN_HERE" \
  -H "Content-Type: application/json"

*** To Open a project you need to know the project name ***

curl -X POST http://localhost:3000/api/open-project \
  -H "Authorization: Bearer YOUR_SECRET_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{ "projectName": "My Project" }'

The new projects feature was exaustive tested but i let for now the debug code

If you find any bug 🪲 please open a issue with the log attached.

I will try to replicate this on the V2 but no promisses...

Please read the for extended features.

Copyright @Carlostkd

warning ⚠️ If you have installed the previous version to use the new features you need install:

npm install multer yaml nodemailer

warning ⚠️ chat loggin function logs the Ghost chats too useful to keep saved chats on your end but not online.

Welcome to Lumo API! 🚀 A powerful and flexible API for interacting with the Lumo AI powered by Proton.

This API allows you to integrate Proton Lumo Assistante in any of your Projects - web apps or mobile apps. 🎉

Key Features ✨

• Send Prompts: Send messages to Lumo and receive responses to interact with Proton Lumo.
• Web Search Toggle: Enable or disable the web search functionality when needed. 🔍
• Secure API: Authentication via token security to make sure only authorized users can send requests. 🔑
• Turn on/off Ghost mode:👻 No one can sees you
• Start Fresh:💬 Start a new chat when you want
• Upload and delete files:💬 Always like a pro
• Chat Logging:💬 Gives you full controle of yours chat
• Help Function: List all available commands
• Talk with Hmas Api: 💬 Get Hacker Messages as Service in your projects
• Lumo-Api can analyze your computer: 💬 Like a real cybersecurity Cat

Installation 🛠️

1. Clone this repository:

git clone https://github.com/carlostkd/lumo-api.git
cd lumo-api

2. Install dependencies:

npm init -y

npm install express puppeteer-core puppeteer body-parser cors multer nodemailer yaml axios


run the app

node index.js

3. Set up your token:

In index.js, replace YOUR_SECRET_TOKEN_HERE with your secret token for API authentication.

4. Run the server:

node index.js

and wait until you see "login detected"

The server will be running on http://localhost:3000.

Usage 🏄‍♂️

Sending a Prompt to Lumo

You can send a prompt using curl:

curl -X POST http://localhost:3000/api/send-prompt   
-H "Authorization: Bearer YOUR_SECRET_TOKEN_HERE"   
-H "Content-Type: application/json"   
-d '{"prompt": "What is the weather in Zurich?"}'

You’ll receive a response from the Lumo like:

"The weather in Zurich is clear skies with a temperature of 15°C."

Enabling Web Search

To enable web search (useful for weather, news, etc.):

curl -X POST http://localhost:3000/api/set-websearch   
-H "Authorization: Bearer YOUR_SECRET_TOKEN_HERE"   
-H "Content-Type: application/json"   
-d '{"enabled": true}'

Disabling Web Search

To disable web search:

curl -X POST http://localhost:3000/api/set-websearch   
-H "Authorization: Bearer YOUR_SECRET_TOKEN_HERE"   
-H "Content-Type: application/json"   
-d '{"enabled": false}'

Enabling Ghost mode

To enable Ghost Mode :

curl -X POST http://localhost:3000/api/set-ghostmode \
  -H "Authorization: Bearer YOUR_SECRET_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}' 

Disabling Ghost mode

To disable Ghost Mode:

curl -X POST http://localhost:3000/api/set-ghostmode \
  -H "Authorization: Bearer YOUR_SECRET_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

Start New Chat

To start a new chat:

curl -X POST http://localhost:3000/api/start-new-chat \
  -H "Authorization: Bearer YOUR_SECRET_TOKEN_HERE" \
  -H "Content-Type: application/json"

Upload Files (max 10 dont know the real limit of Lumo...)

Upload file or multi files:

curl -X POST http://localhost:3000/api/upload-file \
  -H "Authorization: Bearer YOUR_SECRET_TOKEN_HERE" \
  -F "files=@./test.html" \            
  -F "files=@./test2.txt" \
  -F "files=@./test3.txt"

curl -X POST http://localhost:3000/api/upload-file \
  -H "Authorization: Bearer YOUR_SECRET_TOKEN_HERE" \
  -F "files=@./test.html"            

Delete Files

To delete one by one or all:

curl -X POST http://localhost:3000/api/remove-file \
  -H "Authorization: Bearer YOUR_SECRET_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{"mode":"all"}'

curl -X POST http://localhost:3000/api/remove-file \
  -H "Authorization: Bearer YOUR_SECRET_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{"mode":"single"}'

Enable chat Logging

Chat logs are saved when you START A NEW CHAT

Enable Loggin and choose the format (json is default available is txt and csv):

curl -X POST http://localhost:3000/api/set-save-chat \
  -H "Authorization: Bearer YOUR_SECRET_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true, "format": "csv"}'

Disable chat Logging

Chat logs are saved when you START A NEW CHAT you can always disable:

curl -X POST http://localhost:3000/api/set-save-chat \
  -H "Authorization: Bearer YOUR_SECRET_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

Show all available commands

curl http://localhost:3000/api/help

🔄 Lumo vs. Lumo: The Evolving Function Showdown! 🤖⚡

🥊 Round 1: Lumo vs Lumo-api

💬 How It Works

Send Your Prompt ✉️

Type in your initial question or topic Let Lumo know what you're curious about

Set the Turns ⚙️

Choose how many back-and-forth exchanges you want From quick chats to deep dives you're in control!

🔍 Behind the Scenes

Our enhanced code works its magic by:

Analyzing responses in real-time Identifying key topics and themes Generating context-aware follow-up questions Gracefully handling errors to maintain flow

🎯 Why It's Awesome

✅ Natural Conversations: Feels more like talking to a friend than a bot

✅ Smooth Transitions: Effortlessly moves between related topics

✅ Error Resistant: Keeps the conversation going even when things get tricky

✅ Customizable Length: You decide how long the chat should be

✅ Engaging Interactions: Smart follow-ups make conversations more interesting

💡 Try It Out!

curl -X POST http://localhost:3000/api/send-automated-dialogue \
  -H "Authorization: Bearer YOUR_SECRET_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{"initialPrompt": "what is proton lumo", "maxTurns": 30}'

Watch the Conversation Flow 🌊

Sit back and enjoy the natural, engaging dialogue See Lumo smoothly transition between topics Witness intelligent follow-up questions that keep the conversation lively

Troubleshooting ⚠️

• Issue: No response after sending a prompt.

  • Solution: Make sure you're logged in manually in the browser window launched by Puppeteer.

• Issue: Invalid token errors.

  • Solution: Ensure you are passing the correct token in the Authorization header.

🙏 Support the Project

If you find Lumo API useful, consider buying me a coffee (or a whole espresso machine).

Your donation helps keep the AI sharp, the jokes fresh, and the servers humming.

Donate Here ➡️

Contributing 💡

If you'd like to contribute to this project, feel free to fork it, make changes, and open a pull request!

Any improvement, whether big or small, is welcome. 🌱

added python UI Interface