1
0
Fork 0
mirror of https://github.com/maybe-finance/maybe.git synced 2025-07-18 20:59:39 +02:00
Maybe est une application web entièrement open source pour vos finances personnelles. Vous aurez à votre disposition tous les outils et calculatrices interactifs dont vous avez besoin pour visualiser et naviguer dans votre parcours financier. https://maybefinance.com/
Find a file
Zach Gollwitzer 2f6b11c18f
Personal finance AI (v1) (#2022)
* AI sidebar

* Add chat and message models with associations

* Implement AI chat functionality with sidebar and messaging system

- Add chat and messages controllers
- Create chat and message views
- Implement chat-related routes
- Add message broadcasting and user interactions
- Update application layout to support chat sidebar
- Enhance user model with initials method

* Refactor AI sidebar with enhanced chat menu and interactions

- Update sidebar layout with dynamic width and improved responsiveness
- Add new chat menu Stimulus controller for toggling between chat and chat list views
- Improve chat list display with recent chats and empty state
- Extract AI avatar to a partial for reusability
- Enhance message display and interaction styling
- Add more contextual buttons and interaction hints

* Improve chat scroll behavior and message styling

- Refactor chat scroll functionality with Stimulus controller
- Optimize message scrolling in chat views
- Update message styling for better visual hierarchy
- Enhance chat container layout with flex and auto-scroll
- Simplify message rendering across different chat views

* Extract AI avatar to a shared partial for consistent styling

- Refactor AI avatar rendering across chat views
- Replace hardcoded avatar markup with a reusable partial
- Simplify avatar display in chats and messages views

* Update sidebar controller to handle right panel width dynamically

- Add conditional width class for right sidebar panel
- Ensure consistent sidebar toggle behavior for both left and right panels
- Use specific width class for right panel (w-[375px])

* Refactor chat form and AI greeting with flexible partials

- Extract message form to a reusable partial with dynamic context support
- Create flexible AI greeting partial for consistent welcome messages
- Simplify chat and sidebar views by leveraging new partials
- Add support for different form scenarios (chat, new chat, sidebar)
- Improve code modularity and reduce duplication

* Add chat clearing functionality with dynamic menu options

- Implement clear chat action in ChatsController
- Add clear chat route to support clearing messages
- Update AI sidebar with dropdown menu for chat actions
- Preserve system message when clearing chat
- Enhance chat interaction with new menu options

* Add frontmatter to project structure documentation

- Create initial frontmatter for structure.mdc file
- Include description and configuration options
- Prepare for potential dynamic documentation rendering

* Update general project rules with additional guidelines

- Add rule for using `Current.family` instead of `current_family`
- Include new guidelines for testing, API routes, and solution approach
- Expand project-specific rules for more consistent development practices

* Add OpenAI gem and AI-friendly data representations

- Add `ruby-openai` gem for AI integration
- Implement `to_ai_readable_hash` methods in BalanceSheet and IncomeStatement
- Include Promptable module in both models
- Add savings rate calculation method in IncomeStatement
- Prepare financial models for AI-powered insights and interactions

* Enhance AI Financial Assistant with Advanced Querying and Debugging Capabilities

- Implement comprehensive AI financial query system with function-based interactions
- Add detailed debug logging for AI responses and function calls
- Extend BalanceSheet and IncomeStatement models with AI-friendly methods
- Create robust error handling and fallback mechanisms for AI queries
- Update chat and message views to support debug mode and enhanced rendering
- Add AI query routes and initial test coverage for financial assistant

* Refactor AI sidebar and chat layout with improved structure and comments

- Remove inline AI chat from application layout
- Enhance AI sidebar with more semantic HTML structure
- Add descriptive comments to clarify different sections of chat view
- Improve flex layout and scrolling behavior in chat messages container
- Optimize message rendering with more explicit class names and structure

* Add Markdown rendering support for AI chat messages

- Implement `markdown` helper method in ApplicationHelper using Redcarpet
- Update message view to render AI messages with Markdown formatting
- Add comprehensive Markdown rendering options (tables, code blocks, links)
- Enhance AI Financial Assistant prompt to encourage Markdown usage
- Remove commented Markdown CSS in Tailwind application stylesheet

* Missing comma

* Enhance AI response processing with chat history context

* Improve AI debug logging with payload size limits and internal message flag

* Enhance AI chat interaction with improved thinking indicator and scrolling behavior

* Add AI consent and enable/disable functionality for AI chat

* Upgrade Biome and refactor JavaScript template literals

- Update @biomejs/biome to latest version with caret (^) notation
- Refactor AI query and chat controllers to use template literals
- Standardize npm scripts formatting in package.json

* Add beta testing usage note to AI consent modal

* Update test fixtures and configurations for AI chat functionality

- Add family association to chat fixtures and tests
- Set consistent password digest for test users
- Enable AI for test users
- Add OpenAI access token for test environment
- Update chat and user model tests to include family context

* Simplify data model and get tests passing

* Remove structure.mdc from version control

* Integrate AI chat styles into existing prose pattern

* Match Figma design spec, implement Turbo frames and actions for chats controller

* AI rules refresh

* Consolidate Stimulus controllers, thinking state, controllers, and views

* Naming, domain alignment

* Reset migrations

* Improve data model to support tool calls and message types

* Tool calling tests and fixtures

* Tool call implementation and test

* Get assistant test working again

* Test updates

* Process tool calls within provider

* Chat UI back to working state again

* Remove stale code

* Tests passing

* Update openai class naming to avoid conflicts

* Reconfigure test env

* Rebuild gemfile

* Fix naming conflicts for ChatResponse

* Message styles

* Use OpenAI conversation state management

* Assistant function base implementation

* Add back thinking messages, clean up error handling for chat

* Fix sync error when security price has bad data from provider

* Add balance sheet function to assistant

* Add better function calling error visibility

* Add income statement function

* Simplify and clean up "thinking" interactions with Turbo frames

* Remove stale data definitions from functions

* Ensure VCR fixtures working with latest code

* basic stream implementation

* Get streaming working

* Make AI sidebar wider when left sidebar is collapsed

* Get tests working with streaming responses

* Centralize provider error handling

* Provider data boundaries

---------

Co-authored-by: Josh Pigford <josh@joshpigford.com>
2025-03-28 13:08:22 -04:00
.cursor/rules Personal finance AI (v1) (#2022) 2025-03-28 13:08:22 -04:00
.devcontainer devContainer: Use Redis for ActiveJob and ActionCable. (#2017) 2025-03-24 10:00:42 -04:00
.github Update issue templates 2025-03-19 14:05:00 -04:00
app Personal finance AI (v1) (#2022) 2025-03-28 13:08:22 -04:00
bin Personal finance AI (v1) (#2022) 2025-03-28 13:08:22 -04:00
config Personal finance AI (v1) (#2022) 2025-03-28 13:08:22 -04:00
db Personal finance AI (v1) (#2022) 2025-03-28 13:08:22 -04:00
docs/hosting Use Redis for ActiveJob and ActionCable (#2004) 2025-03-19 12:36:16 -04:00
lib Data provider simplification, tests, and documentation (#1997) 2025-03-17 11:54:53 -04:00
log Initial commit 2024-02-02 09:05:04 -06:00
public CSV Imports Overhaul (Transactions, Trades, Accounts, and Mint import support) (#1209) 2024-10-01 10:47:59 -04:00
storage Initial commit 2024-02-02 09:05:04 -06:00
test Personal finance AI (v1) (#2022) 2025-03-28 13:08:22 -04:00
tmp Initial commit 2024-02-02 09:05:04 -06:00
vendor Add new category flow (#1857) 2025-02-24 11:08:05 -05:00
.dockerignore Initial commit 2024-02-02 09:05:04 -06:00
.editorconfig Rubocop updates (#1118) 2024-08-23 10:06:24 -04:00
.env.example Use Redis for ActiveJob and ActionCable (#2004) 2025-03-19 12:36:16 -04:00
.env.local.example Initial pass at Synth-based ticker selection (#1392) 2024-10-30 09:23:44 -04:00
.env.test.example Data provider simplification, tests, and documentation (#1997) 2025-03-17 11:54:53 -04:00
.erb_lint.yml Handle nil name for entries (#1550) 2024-12-16 12:52:11 -05:00
.gitattributes Initial commit 2024-02-02 09:05:04 -06:00
.gitignore Personal finance AI (v1) (#2022) 2025-03-28 13:08:22 -04:00
.rubocop.yml Rubocop updates (#1118) 2024-08-23 10:06:24 -04:00
.ruby-version Bump to Ruby 3.4.1 (#1721) 2025-01-27 19:59:16 -05:00
biome.json Add BiomeJS for Linting and Formatting JavaScript relates to #1295 (#1299) 2024-10-14 17:09:27 -04:00
compose.example.yml Use Redis for ActiveJob and ActionCable (#2004) 2025-03-19 12:36:16 -04:00
config.ru Initial commit 2024-02-02 09:05:04 -06:00
CONTRIBUTING.md Cursor rules and project design overview (#1788) 2025-02-03 19:30:03 -05:00
Dockerfile Fix commit resolution for Docker builds 2025-03-04 07:50:21 -05:00
Gemfile Personal finance AI (v1) (#2022) 2025-03-28 13:08:22 -04:00
Gemfile.lock Personal finance AI (v1) (#2022) 2025-03-28 13:08:22 -04:00
LICENSE Initial commit 2024-02-02 09:05:04 -06:00
package-lock.json Personal finance AI (v1) (#2022) 2025-03-28 13:08:22 -04:00
package.json Personal finance AI (v1) (#2022) 2025-03-28 13:08:22 -04:00
Procfile.dev Use Redis for ActiveJob and ActionCable (#2004) 2025-03-19 12:36:16 -04:00
Rakefile Initial commit 2024-02-02 09:05:04 -06:00
README.md Use Redis for ActiveJob and ActionCable (#2004) 2025-03-19 12:36:16 -04:00

dashboard_mockup (Note: The image above is a mockup of what we're working towards. We're rapidly approaching the functionality shown, but not all of the parts are ready just yet.)

Maybe: The OS for your personal finances

Get involved: DiscordWebsiteIssues

Backstory

We spent the better part of 2021/2022 building a personal finance + wealth management app called, Maybe. Very full-featured, including an "Ask an Advisor" feature which connected users with an actual CFP/CFA to help them with their finances (all included in your subscription).

The business end of things didn't work out, and so we shut things down mid-2023.

We spent the better part of $1,000,000 building the app (employees + contractors, data providers/services, infrastructure, etc.).

We're now reviving the product as a fully open-source project. The goal is to let you run the app yourself, for free, and use it to manage your own finances and eventually offer a hosted version of the app for a small monthly fee.

Maybe Hosting

There are 3 primary ways to use the Maybe app:

  1. Managed (easiest) - we're in alpha and release invites in our Discord
  2. Self-host with Docker

Contributing

Before contributing, you'll likely find it helpful to understand context and general vision/direction.

Once you've done that, please visit our contributing guide to get started!

Local Development Setup

If you are trying to self-host the Maybe app, stop here. You should read this guide to get started.

The instructions below are for developers to get started with contributing to the app.

Requirements

  • See .ruby-version file for required Ruby version
  • PostgreSQL >9.3 (ideally, latest stable version)

After cloning the repo, the basic setup commands are:

cd maybe
cp .env.local.example .env.local
bin/setup
bin/dev

# Optionally, load demo data
rake demo_data:reset

And visit http://localhost:3000 to see the app. You can use the following credentials to log in (generated by DB seed):

  • Email: user@maybe.local
  • Password: password

For further instructions, see guides below.

Multi-currency support

If you'd like multi-currency support, there are a few extra steps to follow.

  1. Sign up for an API key at Synth. It's a Maybe product and the free plan is sufficient for basic multi-currency support.
  2. Add your API key to your .env file.

Setup Guides

Repo Activity

Repo Activity

Maybe is distributed under an AGPLv3 license. " Maybe" is a trademark of Maybe Finance, Inc.