claudemol 0.1.0__tar.gz → 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,9 +1,9 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: claudemol
3
- Version: 0.1.0
3
+ Version: 0.2.0
4
4
  Summary: PyMOL integration for Claude Code - control molecular visualization via natural language
5
- Project-URL: Homepage, https://github.com/ANaka/ai-mol
6
- Project-URL: Repository, https://github.com/ANaka/ai-mol
5
+ Project-URL: Homepage, https://github.com/ANaka/claudemol
6
+ Project-URL: Repository, https://github.com/ANaka/claudemol
7
7
  Author: Alex Naka
8
8
  License: MIT
9
9
  License-File: LICENSE
@@ -20,12 +20,10 @@ Classifier: Topic :: Scientific/Engineering :: Visualization
20
20
  Requires-Python: >=3.10
21
21
  Description-Content-Type: text/markdown
22
22
 
23
- # ai-mol: Control PyMOL with Claude Code
23
+ # claudemol: Control PyMOL with Claude Code
24
24
 
25
25
  Control PyMOL through natural language using Claude Code. This integration enables conversational structural biology, molecular visualization, and analysis.
26
26
 
27
- https://github.com/user-attachments/assets/687f43dc-d45e-477e-ac2b-7438e175cb36
28
-
29
27
  ## Features
30
28
 
31
29
  - **Natural language control**: Tell Claude what you want to visualize and it executes PyMOL commands
@@ -49,30 +47,20 @@ Claude Code → TCP Socket (port 9880) → PyMOL Plugin → cmd.* execution
49
47
 
50
48
  ### Installation
51
49
 
52
- 1. **Clone the repository:**
53
-
54
- ```bash
55
- git clone https://github.com/ANaka/ai-mol
56
- cd ai-mol
57
- ```
58
-
59
- 2. **Set up the PyMOL plugin:**
60
-
61
- Add this line to your `~/.pymolrc` (create it if it doesn't exist):
62
-
63
- ```python
64
- run /path/to/ai-mol/claude_socket_plugin.py
65
- ```
50
+ ```bash
51
+ pip install claudemol
52
+ claudemol setup
53
+ ```
66
54
 
67
- Replace `/path/to/ai-mol` with the actual path where you cloned the repository.
55
+ This installs the package and configures PyMOL to auto-load the socket plugin.
68
56
 
69
- 3. **Start using it:**
57
+ ### Start Using It
70
58
 
71
- Open Claude Code in the `ai-mol` directory and say:
59
+ Open Claude Code and say:
72
60
 
73
- > "Open PyMOL and load structure 1UBQ"
61
+ > "Open PyMOL and load structure 1UBQ"
74
62
 
75
- Claude will launch PyMOL (with the socket listener active) and load the structure.
63
+ Claude will launch PyMOL (with the socket listener active) and load the structure.
76
64
 
77
65
  ## Usage
78
66
 
@@ -126,9 +114,8 @@ Claude Code has built-in skills for common workflows:
126
114
 
127
115
  ### Plugin Not Loading
128
116
 
129
- - Verify the path in your `~/.pymolrc` is correct
117
+ - Run `claudemol setup` to configure PyMOL
130
118
  - Check PyMOL's output for any error messages on startup
131
- - Try running `run /path/to/claude_socket_plugin.py` manually in PyMOL
132
119
 
133
120
  ### First-Time Setup Help
134
121
 
@@ -139,9 +126,9 @@ Run the `/pymol-setup` skill in Claude Code for guided setup assistance.
139
126
  The default socket port is **9880**. Both the plugin and Claude Code connection module use this port.
140
127
 
141
128
  Key files:
142
- - `claude_socket_plugin.py` - PyMOL plugin (headless, auto-loads via pymolrc)
143
- - `pymol_connection.py` - Python module for socket communication
144
- - `.claude/skills/` - Claude Code skills for PyMOL workflows
129
+ - `src/claudemol/plugin.py` - PyMOL plugin (auto-loads via pymolrc)
130
+ - `src/claudemol/connection.py` - Python module for socket communication
131
+ - `claude-plugin/skills/` - Claude Code skills for PyMOL workflows
145
132
 
146
133
  ## Limitations
147
134
 
@@ -1,9 +1,7 @@
1
- # ai-mol: Control PyMOL with Claude Code
1
+ # claudemol: Control PyMOL with Claude Code
2
2
 
3
3
  Control PyMOL through natural language using Claude Code. This integration enables conversational structural biology, molecular visualization, and analysis.
4
4
 
5
- https://github.com/user-attachments/assets/687f43dc-d45e-477e-ac2b-7438e175cb36
6
-
7
5
  ## Features
8
6
 
9
7
  - **Natural language control**: Tell Claude what you want to visualize and it executes PyMOL commands
@@ -27,30 +25,20 @@ Claude Code → TCP Socket (port 9880) → PyMOL Plugin → cmd.* execution
27
25
 
28
26
  ### Installation
29
27
 
30
- 1. **Clone the repository:**
31
-
32
- ```bash
33
- git clone https://github.com/ANaka/ai-mol
34
- cd ai-mol
35
- ```
36
-
37
- 2. **Set up the PyMOL plugin:**
38
-
39
- Add this line to your `~/.pymolrc` (create it if it doesn't exist):
40
-
41
- ```python
42
- run /path/to/ai-mol/claude_socket_plugin.py
43
- ```
28
+ ```bash
29
+ pip install claudemol
30
+ claudemol setup
31
+ ```
44
32
 
45
- Replace `/path/to/ai-mol` with the actual path where you cloned the repository.
33
+ This installs the package and configures PyMOL to auto-load the socket plugin.
46
34
 
47
- 3. **Start using it:**
35
+ ### Start Using It
48
36
 
49
- Open Claude Code in the `ai-mol` directory and say:
37
+ Open Claude Code and say:
50
38
 
51
- > "Open PyMOL and load structure 1UBQ"
39
+ > "Open PyMOL and load structure 1UBQ"
52
40
 
53
- Claude will launch PyMOL (with the socket listener active) and load the structure.
41
+ Claude will launch PyMOL (with the socket listener active) and load the structure.
54
42
 
55
43
  ## Usage
56
44
 
@@ -104,9 +92,8 @@ Claude Code has built-in skills for common workflows:
104
92
 
105
93
  ### Plugin Not Loading
106
94
 
107
- - Verify the path in your `~/.pymolrc` is correct
95
+ - Run `claudemol setup` to configure PyMOL
108
96
  - Check PyMOL's output for any error messages on startup
109
- - Try running `run /path/to/claude_socket_plugin.py` manually in PyMOL
110
97
 
111
98
  ### First-Time Setup Help
112
99
 
@@ -117,9 +104,9 @@ Run the `/pymol-setup` skill in Claude Code for guided setup assistance.
117
104
  The default socket port is **9880**. Both the plugin and Claude Code connection module use this port.
118
105
 
119
106
  Key files:
120
- - `claude_socket_plugin.py` - PyMOL plugin (headless, auto-loads via pymolrc)
121
- - `pymol_connection.py` - Python module for socket communication
122
- - `.claude/skills/` - Claude Code skills for PyMOL workflows
107
+ - `src/claudemol/plugin.py` - PyMOL plugin (auto-loads via pymolrc)
108
+ - `src/claudemol/connection.py` - Python module for socket communication
109
+ - `claude-plugin/skills/` - Claude Code skills for PyMOL workflows
123
110
 
124
111
  ## Limitations
125
112
 
@@ -1,23 +1,23 @@
1
- # ai-mol Skills for Claude Code
1
+ # claudemol Skills for Claude Code
2
2
 
3
3
  PyMOL visualization skills for Claude Code.
4
4
 
5
5
  ## Installation
6
6
 
7
7
  ```bash
8
- /plugin marketplace add ANaka/ai-mol?path=claude-plugin
9
- /plugin install ai-mol-skills
8
+ /plugin marketplace add ANaka/claudemol?path=claude-plugin
9
+ /plugin install claudemol-skills
10
10
  ```
11
11
 
12
12
  Then restart Claude Code.
13
13
 
14
14
  ## Prerequisites
15
15
 
16
- You need the `ai-mol` pip package installed:
16
+ You need the `claudemol` pip package installed:
17
17
 
18
18
  ```bash
19
- pip install ai-mol
20
- ai-mol setup
19
+ pip install claudemol
20
+ claudemol setup
21
21
  ```
22
22
 
23
23
  ## Available Skills
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "claudemol"
3
- version = "0.1.0"
3
+ version = "0.2.0"
4
4
  description = "PyMOL integration for Claude Code - control molecular visualization via natural language"
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.10"
@@ -24,8 +24,8 @@ dependencies = []
24
24
  claudemol = "claudemol.cli:main"
25
25
 
26
26
  [project.urls]
27
- Homepage = "https://github.com/ANaka/ai-mol"
28
- Repository = "https://github.com/ANaka/ai-mol"
27
+ Homepage = "https://github.com/ANaka/claudemol"
28
+ Repository = "https://github.com/ANaka/claudemol"
29
29
 
30
30
  [build-system]
31
31
  requires = ["hatchling"]
@@ -138,7 +138,7 @@ Commands:
138
138
  info Show installation info
139
139
 
140
140
  For Claude Code skills, install the claudemol-skills plugin:
141
- /plugin marketplace add ANaka/ai-mol?path=claude-plugin
141
+ /plugin marketplace add ANaka/claudemol?path=claude-plugin
142
142
  /plugin install claudemol-skills
143
143
  """,
144
144
  )
@@ -195,7 +195,7 @@ def launch_pymol(file_path=None, wait_for_socket=True, timeout=10.0):
195
195
  if not pymol_cmd:
196
196
  raise RuntimeError(
197
197
  "PyMOL not found. Please install PyMOL:\n"
198
- " - Run: ai-mol setup\n"
198
+ " - Run: claudemol setup\n"
199
199
  " - Or: pip install pymol-open-source-whl\n"
200
200
  " - Or: brew install pymol (macOS)"
201
201
  )
@@ -4,7 +4,7 @@ Visual feedback helper for PyMOL.
4
4
  Provides a simple way to execute commands and save/view the result.
5
5
 
6
6
  Usage:
7
- from ai_mol.view import pymol_view
7
+ from claudemol.view import pymol_view
8
8
 
9
9
  # Execute commands and save a snapshot
10
10
  path = pymol_view("cmd.fetch('1ubq'); cmd.show('cartoon')", name="ubq_cartoon")
@@ -21,7 +21,7 @@ from pathlib import Path
21
21
 
22
22
  DEFAULT_HOST = "localhost"
23
23
  DEFAULT_PORT = 9880
24
- SCRATCH_DIR = Path.home() / ".ai-mol" / "scratch"
24
+ SCRATCH_DIR = Path.home() / ".claudemol" / "scratch"
25
25
 
26
26
 
27
27
  def ensure_scratch_dir():
File without changes
File without changes