Hugging Face's logo

Spaces:
MakiAi
/
CodeLumia
Sleeping

App Files Community
CodeLumia / README.md
MakiAi's picture
MakiAi
Update README.md
e9078a9 verified
preview code
|
raw
history blame contribute delete
6.09 kB
metadata
title: CodeLumia
emoji: 📚
colorFrom: purple
colorTo: blue
sdk: docker
app_port: 8501
app_file: app.py
pinned: false
license: mit


CodeLumia

～Learn to Code, Step by Step～

Hugging Face SpacesGitHub Release

🚀 はじめに

CodeLumiaへようこそ！CodeLumiaは、GitHubリポジトリのソースコードを分析し、包括的なマークダウン形式のドキュメントを自動生成するツールです。プロジェクトの構造、依存関係、設定などを簡単に理解できるようになります。

CodeLumiaは、開発者がコードベースをすばやく把握し、プロジェクトに効率的に貢献できるようにすることを目的としています。新しいチームメンバーのオンボーディングを容易にし、コードの保守性を向上させます。

このリポジトリはSourceSageを活用しており、リリースノートやREADME、コミットメッセージの9割はSourceSage ＋ claude.aiで生成しています。

主な特徴:

  • GitHubリポジトリの自動分析
  • マークダウン形式のドキュメント生成
  • ファイルとディレクトリの無視パターンのカスタマイズ
  • わかりやすいStreamlitユーザーインターフェース

CodeLumiaを使用して、プロジェクトのドキュメンテーションを強化し、チームのコラボレーションを促進しましょう。ぜひお試しください！

デモアプリ

Hugging Face Spaces

更新履歴

[2024/04/15] CodeLumia v0.4.0

  • プレビュー機能の追加（ファイルツリー、マークダウン、プレーンテキスト）
  • リポジトリのスキャンとマークダウンファイルの生成機能を強化
  • ドキュメンテーションの改善とコードの可読性向上
  • ファイル操作とGit操作のモジュールを改善

[2024/04/13] CodeLumia v0.3.0

  • アプリケーションの機能強化とドキュメントデザインの更新
  • デモGIFの更新
  • .CodeLumiaignoreのフォーマット更新とリファクタリング
  • READMEとSourceSageDocsの大幅な更新
  • GIFファイルのGit LFSでの追跡と誤記修正

[2024/04/13] CodeLumia v0.2.0

  • コードのリファクタリングによる可読性と保守性の向上
  • リポジトリのURLを入力してファイルツリーとコードを表示する機能追加
  • ユーザーインターフェースの改善とドキュメンテーションの拡充
  • CI/CDの設定とREADMEファイルの更新

[2024/04/12] CodeLumia v0.1.0

  • 初回リリース

前提条件

  • Docker
  • Docker Compose

インストール

  1. リポジトリをクローンします:

    git clone https://github.com/Sunwood-ai-labs/CodeLumia.git
cd CodeLumia

  2. Dockerコンテナをビルドして実行します:

    docker-compose up --build

  3. ブラウザで http://localhost:8501 にアクセスしてアプリケーションを開きます。

📖 使い方

  1. 分析したいGitHubリポジトリのURLをテキスト入力フィールドに入力します。
  2. アプリケーションがリポジトリをクローンし、ファイルを処理して、マークダウンのドキュメントファイルを生成します。
  3. 生成されたドキュメントがStreamlitアプリに表示されます。
  4. "Download Markdown File"リンクをクリックして、マークダウンファイルをダウンロードできます。

Full Textのところからクリップボードにコピーすることもできます

🔧 設定

  • .CodeLumiaignoreファイルには、ドキュメント生成プロセス中に無視する特定のファイルとディレクトリのパターンが含まれています。これらのパターンは、Streamlitアプリのサイドバーで編集できます。

📂 プロジェクト構造 

CodeLumia/
├─ .github/
│  └─ workflows/
│     └─ run.yaml
├─ docs/
│  ├─ language_map.json
│  ├─ page_front.md
│  └─ SourceSageDocs.md
├─ modules/
│  ├─ file_operations.py
│  ├─ git_operations.py
│  └─ markdown_operations.py
├─ app.py
├─ CodeLumia.md
├─ docker-compose.yml
├─ Dockerfile
├─ README.md
└─ requirements.txt

🤝 コントリビューション

コントリビューションは大歓迎です！問題を見つけたり、改善のための提案がある場合は、issueを開くかプルリクエストを送ってください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。 ```