Lucy AI/Docs
GitHubOpen app

Getting started

  • Introduction
  • Quick start
  • Desktop app

Using Lucy

  • Chat & models
  • Skills
  • Members
  • Calendar & meetings
  • Files in chat
  • Memory
  • Personas
  • Connectors
  • Workflows
  • Channels
  • Voice
  • Security & 2FA
  • Themes & account

Developers

  • Architecture
  • Self-hosting
  • Embedding Lucy
  • HTTP API
  • CLI
  • MCP server
  • Contributing

Files in chat

Send pictures and documents in any chat: a chat with Lucy, a direct chat with a teammate, or a group. Lucy can look at pictures and read text files and PDFs.

Files need the connected (account) version of Lucy. The desktop app in standalone mode has no paperclip.

Sending a file

There are three ways:

  • Paperclip: click the paperclip under the message box and pick one or more files.
  • Drag and drop: drag files from your computer onto the chat.
  • Paste: copy a picture (for example a screenshot) and press Ctrl+V (Cmd+V on a Mac) in the message box.

Each file shows above the message box with its name, size and how far it has been sent. Click x to take one out. Send works once every file has been sent; you can send files without writing anything.

A message takes up to 10 files, each up to 25 MB.

Which files

TypeLucy reads it
Pictures: JPG, PNG, WebP, GIFYes, with a model that can see pictures (Claude, GPT, Gemini, Grok, Mistral)
PDFYes, the text in it (not scanned pages)
Text: TXT, MD, CSV, JSONYes
Word, Excel, PowerPoint (DOCX, XLSX, PPTX), ZIPNot yet: they can be sent and opened by your teammates

iPhone photos in HEIC are not taken yet. On the iPhone choose Settings › Camera › Formats › Most Compatible, or send the photo as JPG.

Programs (.exe and similar) are never taken. A file must really be what its name says: a program renamed to .jpg is refused.

Seeing files

Pictures show in the chat. Click one to see it large, with Download. Other files show as a card with Open.

Everyone who can see the chat can see its files. Nobody else can, not even with the link.

Asking Lucy about a file

Send the file with your question, for example "What does this invoice say?" or "Describe this picture". Lucy reads the files from the last 10 messages that have files. In a chat with teammates, type @lucy and she reads the chat's files the same way.

If the model you picked cannot see pictures, Lucy says so: pick another model in the model menu.

Your files and space

Account › Files lists the files you sent in this workspace, newest first, with a search by name. It shows how much space you use and how much your package gives you:

PackageSpace per person
No package1 GB
Lucy Solo5 GB
Lucy Team10 GB
Lucy Business25 GB

When you are full, Lucy tells you and does not take the file. Delete some files, or ask your workspace owner about a bigger package.

Delete removes the file for everyone: the chat shows "File deleted" in its place and Lucy can no longer read it. Deleting a chat deletes its files too. A file you sent but never put in a message is removed after 7 days.

For admins

Lucy admins choose where files are kept in Admin › File storage: a Cloudflare R2 bucket or any S3 bucket. Fill in the bucket and its keys, Save, then Test. The line "Files go to" shows where new files are kept.

Calendar & meetingsMemory